A docker-compose-powered stack to get your PHP project running in no time.

• PHP-FPM 7.1
• nginx
• MariaDB
• Node w/ Yarn

• Docker v17.03.1-ce or higher
• docker-compose v1.11.2 or higher

To start the stack, run:

    docker-compose up -d --build --remove-orphans

• The -d flag daemonises the stack.
• The --build builds services (e.g. php-fpm, nginx) that comprise the stack.
• The --remove-orphans stack ensures that services that aren't being used are deleted (to save disk space).

Provided that no errors were emitted during the start, you should be able to visit your browser on http://localhost:8080.

To stop the stack, run:

    docker-compose stop

To connect to the MariaDB service, run:

    docker-compose exec mariadb mysql -uapp -p

• This command uses the app user. There is also a root user.
• Use the password defined on the docker-compose.yml file.

To install composer dependencies, run:

    docker-compose run --rm composer install

• The --rm flag ensures that that intermediate (temporary) containers are deleted once you install packages (to save disk space).
• The service's data is mounted on the ./mariadb host folder, which means that data will persist between docker-compose ups and stops.

To install npm packages, run:

    docker-compose run --rm yarn add [name-of-package]

• yarn is faster than npm and contains a lockfile (yarn.lock), for deterministic dependency resolution.

If you want to extend the functionality of a service (e.g. php-fpm), you have to re-build it.

To accomplish this, modify the Dockerfile, then run:

    docker-compose build --no-cache --force-rm [name-of-service]

... followed by a docker-compose up [arguments...]

• This stack was built on macOS Sierra v10.12.5. Experience may vary on other operating systems.