Containerized PHP application for Laravel Development
Switch branches/tags
Nothing to show
Clone or download
Latest commit f6467aa Feb 5, 2018
Failed to load latest commit information.
.vscode Added a container to debug Jan 10, 2017
caddy Updates Feb 4, 2018
data Data folder Nov 16, 2016
nginx Updates Feb 4, 2018
.env Updates Feb 4, 2018
.gitignore Added a container to debug Jan 10, 2017
LICENSE Update LICENSE Feb 13, 2017 Update Feb 5, 2018
docker-compose.yml Updates Feb 4, 2018

Containerized PHP application for Laravel Development

What is this?

This an example to how using Docker as development environment for Laravel/Lumen.

What is included

This docker-compose contains the basic pieces to build an applications with PHP.

  • PHP7
  • Nginx or Caddy
  • Postgres
  • Redis

How to use

1. Get the files and spin up containers

# Get shipping-docker files
git clone
cd laravel-docker

# Start the app, run containers in the background
# This will download and build the images the first time you run this
docker-compose up -d

At this point, we've created containers and have them up and running. However, we didn't create a Laravel application to serve yet. We waited because we wanted a PHP image to get created so we can re-use it and run composer commands.

2. Create a new Laravel application

Note: You need delete the files in path app before run the command bellow.

From directory laravel-docker the following command to create the Laravel app:

docker run -it --rm \
           -v $(pwd)/app:/app \
           -w /app \
           petronetto/php7-alpine \
           composer create-project laravel/laravel .

Now, install Redis driver:

docker run -it --rm \
           -v $(pwd)/app:/app \
           -w /app \
           petronetto/php7-alpine \
           composer require predis/predis

In Linux, maybe you need run the follow ommand to set directory ownership to you sudo chown -R $USER:$USER .

Edit the app/.env file to have correct settings for our containers. Adjust the following as necessary:




If you already have an application, you can move it to the app directory here. Else, you can adjust the shared volume file paths within the docker-compose.yml file.

If you edit the docker-compose.yml file, run docker-compose down; docker-compose up -d to suck in the new Volume settings.

NOTE: If you're not running Docker Mac/Windows (which run Docker in a small virtualized layer), you may need to set permissions on the shared directories that Laravel needs to write to. The following will let Laravel write the storage and bootstrap directories:

# From directory laravel-docker
sudo chmod -R o+rw app/bootstrap app/storage

3. (Optionally) Add Auth Scaffolding:

If you'd like, we can add Laravel's Auth scaffolding as well. To do that, we need to run some Artisan commands:

# Scaffold authentication views/routes
docker exec -it php-fpm php artisan make:auth

# Run migrations for auth scaffolding
docker exec -it php-fpm php artisan migrate

Remote debug

The container is configured to run the file that bootstrap applications in folder /app/public, because I use Laravel/Lumen by default, so, if you don't use a framework that bootstrap the application in this folder, you must put your source files there. To the debug works, you must:

  1. Set your local IP address in XDEBUG_HOST environment variable in docker-compose.yml.

  2. Configure your editor/IDE to map the local source and the remote source.

VS Code

Install PHP Debug Extension.

Put this config in your launch.json:

NOTE this example will map the local folder app, to /app on the container. Remenber that container is configured to boostrap in /app/public, as the example provided in this repo.

    "version": "0.2.0",
    "configurations": [
            "name": "XDebug",
            "type": "php",
            "request": "launch",
            "port": 9000,
            "pathMappings": {
                "/app": "${workspaceRoot}"
            "ignore": ["**/vendor/**/*.php"]

Check the Sublime and PHPStorm configs here