Download the PHP package reflexions/docker-laravel without Composer

reflexions/docker-laravel

by Reflexions

• Only depends on the Docker Toolbox
• Edit with Sublime, PhpStorm, Eclipse, etc
• Installs everything necessary to get started - laravel, php, database
  • Can start with empty directory or existing laravel project
  • No need to install PHP via homebrew / MacPorts / .MSI / apt-get / yum / etc
• Addresses permissions errors without requiring chmod 777

Instructions

1.) Install Docker Toolbox to get docker, docker-compose, and the Kitematic GUI. Open a terminal with the docker env variables via Kitematic -> File -> Open Docker Command Line Terminal

2.) Create a docker-compose.yml in the project directory. Define the laravel service and any desired database services:

3.) Obtain a Github Personal Access Token. Create an .env file in the project directory. Configure laravel and other services as desired. The database service above corresponds to DB_HOST=database below:

4.) With one command download the images, create the service containers, and start the application:

5.) (optional) APP_KEY

6.) (optional) Tinker

Overview

• Runs setup script first time
• Uses github token to avoid composer rate limit errors
• Downloads fresh laravel 5.2 if the app directory is missing
• Adds dependency on reflexions/docker-laravel composer package
• Updates bootstrap/app.php to use Reflexions\DockerLaravel\DockerApplication to prevent permissions errors

Front-end build systems

Front-end build systems (gulp, grunt, bower, etc) are best installed outside of docker. The resulting assets will be readily accessible via the volume mapping defined on the laravel service.

Elastic Beanstalk

Add a Dockerfile to the root of the project to deploy with Elastic Beanstalk:

This will define an application container. Use RDS to create the database. Add all variables from the .env file (including the APP_KEY, DB_HOST, etc) into the AWS Management Console -> Elastic Beanstalk -> Your-Environment -> Configuration -> Software Configuration.

Troubleshooting

Problem: Mac OS X: Couldn't connect to docker daemon

Solution: Open terminal with Kitematic -> File -> Open Docker Command Line Terminal.

Problem: Don't like the Docker Command Line Terminal

Solution: Run Kitematic -> Install Docker Commands. Then add the following line _~/.bashprofile:

Problem: Changes to .env file apparently ignored by laravel

Solution: Restart cluster. Settings in the .env file are only read on start.

Problem: Mac OS X: Illegal Instruction 4

Solution: Known issue with the Docker Toolbox on older CPUs. Install docker-compose using pip

Problem: Can't connect to database

Solution:

• Check that the DB_CONNECTION corresponds to the correct laravel db driver
• Check that the DB_HOST corresponds to the name of the service listed in docker-compose.yml (i.e. "database" in the example above)

Problem: RuntimeException: No supported encrypter found. The cipher and / or key length are invalid.

Solution:

• Run php artisan key:generate to update APP_KEY on .env, then restart the container.

Problem: Want to use mysql instead of postgres

Solution:

• Modify docker-config.yml to reference MySQL:

• Modify .env to reference MySQL:

Problem: Want to use mysql already running on local machine (not docker)

Solution:

• Modify docker-config.yml to drop the unnecessary database service:

• Modify .env to connect to MySQL via the docker-machine host ip address (192.168.99.1):

• Ensure that "bind_address" config parameter is set to 0.0.0.0 on startup. This can be set by your my.cnf, or it can be hard coded in your startup script. To check the value use this sql:

• Ensure that the database username has permission to connect from the docker container (usually 192.168.99.100)