docker-compose-laravel

A pretty simplified Docker Compose workflow that sets up a LEMP network of containers for local Laravel development. You can view the full article that inspired this repo here.

Usage

To get started, make sure you have Docker installed on your system, and then clone this repository.

Next, navigate in your terminal to the directory you cloned this, and spin up the containers for the web server by running docker-compose up -d --build site.

After that completes, follow the steps from the src/README.md file to get your Laravel project added in (or create a new blank one).

Bringing up the Docker Compose network with site instead of just using up, ensures that only our site's containers are brought up at the start, instead of all of the command containers as well. The following are built for our web server, with their exposed ports detailed:

• nginx - :8080

• mysql - :3306

• php - :9000

• redis - :6379

• phpmyadmin - :8081

Three additional containers are included that handle Composer, NPM, and Artisan commands without having to have these platforms installed on your local computer. Use the following command examples from your project root, modifying them to fit your particular use case.

• docker-compose run --rm composer update
• docker-compose run --rm npm run dev
• docker-compose run --rm artisan migrate

Environment Variables

# Application ENV Variables
APP_PATH=./src
APP_PORT=8080

# mysql Database ENV Variables
DB_PORT=3306
DB_MYSQL_USER=homestead
DB_NAME=homestead
DB_MYSQL_PASSWORD=secret
DB_ROOT_PASSWORD=secret
DB_VERSION=latest

# npm ENV Variables
NPM_VERSION=latest

# redis ENV Variables
REDIS_VERSION=latest
REDIS_PORT=6379
REDIS_PASSWORD=redispassword

# phpmyadmin ENV Variables
PHPMYADMIN_PORT=8081

# Other
DOCUMENT_ROOT=/var/www/html:delegated

Persistent MySQL Storage

By default, whenever you bring down the Docker network, your MySQL data will be removed after the containers are destroyed. If you would like to have persistent data that remains after bringing containers down and back up, do the following:

1. Create a mysql folder in the project root, alongside the nginx and src folders.
2. Under the mysql service in your docker-compose.yml file, add the following lines:

volumes:
  - ./mysql:/var/lib/mysql

Persistent Redis Storage

1. Create a redis folder in the project root, alongside the nginx and src folders.
2. Under the redis service in your docker-compose.yml file, add the following lines:

volumes:
        - ./redis:/data