jeroeng/alpine-artisan repository overview

⁠🏔️ Artisanal Docker images with Alpine Linux

A set of lightweight Docker images created with Laravel in mind, but work just as fine for other applications. At the basis lies Alpine Linux and the amazing Docker-Webstack⁠ which keeps the images that you pull in very small but usable.

The image sets you up with Alpine Linux, PHP-FPM, Nginx. Currently there is an image for PHP 7.3 and 7.4 available. The 7.4 has to be based on the codecasts⁠ repository, meaning that the set of installed PHP extensions may differ from the set installed in the 7.3 image.

⁠Installation

In the folder of your application create two files: docker-compose.yml and Dockerfile (note that the latter has no extension). On the command line, run docker compose up -d --build and view your containerized application at localhost:80.

The docker image contains a healthcheck. You can run the command docker-compose ps to see if the build was succesful, the state should mention "Up (healthy)" for the app container.

⁠Docker-compose.yml

services:
  app:
    build: .
    ports:
      - 80:80

⁠Dockerfile

FROM jeroeng/alpine-artisan:web7.3

⁠Configuration

In the end, the best Docker setup is one you create yourself. That being said, this is how you could quickly build upon the Docker image from this repository.

⁠Using a database

Percona⁠ is an (optimized) version of MySQL and very useful as your database server. Add the following to your docker-compose.yml file:

services:
  # app container definition

  db:
    image: percona:5.7
      environment:
        - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD:-secret}
        - MYSQL_DATABASE=my_database
        - MYSQL_USER=jeroen
        - MYSQL_PASSWORD=${MYSQL_ROOT_PASSWORD:-secret}
      volumes:
        - mysql-data:/var/lib/mysql:rw
      ports:
        - 3306:3306
volumes:
  mysql-data: # nothing necessary here, let Docker manage the storage

Your application's .env should contain the following environment variables, after that run docker compose up -d --build again to have a database container running next to your app.

DB_CONNECTION=mysql
DB_HOST=database
DB_PORT=3306
DB_DATABASE=my_database
DB_USERNAME=jeroen
DB_PASSWORD=secret

⁠Using Redis

A typical use of redis is for queues (possibly in combination with Laravel Horizon). To have a redis container, add to the docker-compose.yml file:

services:
  # app container definition

  queue:
      image: redis:5-alpine
      ports:
        - 6379:6379

Adapt your .env file as well, and after another docker compose up -d --build you will have a redis container running for your application (yes, there is no password in this case). If you want to use Horizon, you would still need to install it in your application.

QUEUE_CONNECTION=redis
REDIS_HOST=queue
REDIS_PASSWORD=
REDIS_PORT=6379

⁠Contributing

Clone this repository and run make to see which commands are there to help you. every command requires a TAG= parameter, which is the Docker image you want to build, for example: make build TAG=web7.3.