markkimsal/php-platform repository overview

https://github.com/markkimsal/laravel-docker-platform⁠

⁠laravel-docker-platform

Docker container for Laravel and PHP projects. Graceful shutdown. No-python supervisor. No-SSH.

⁠Customizing

You can add your own services into /platform/services.

You can add your own one time, start-up scripts into /platform/start-container.d/

⁠PHP Extensions

I found that each extension barely takes up any more disk space or memory. If you don't want them, attach blank files to the container ini files when you deploy.

⁠Tools images

Having an image that can also run tests and build your image as part of your CI pipeline is useful. I could not find an image of nodejs that also had git, and at least one of my node dependencies required git to install so... here we are with nodejs 14 baked into this image.

Sometimes composer complains when you don't have a host OS unzip program, so that's been added to the tools variant.

Also, for deploying with PHP deployer, I found that having ssh, unzip, git are usefull or required.

I used to use altax for remote deployment so that's also on there.

⁠Supervisor runit

Runit is a small, c process supervisor. It tries to restart failed processes until you tell it to stop. The problem with runit is that you cannot send a signal that will gracefully stop all managed services. You must stop all services "by-hand", which is weird. You'd think that a simple SIGSTOP could initiate a graceful shutdown, but there's no way to do this. Runit (or runsv or runsvdir) will respond to TERM signals mostly by dieing immediately and letting children float to PID 1 and get reaped.

There is a small bash file that - in combination with dumb-init - will act as pid 1, take docker stop SIGQUIT or SIGTERM and gracefully try to shutdown the running services. This is essentially what the /sbin/my_init program from phusion/baseimage does.

⁠Development and building your own images

Update the all Dockerfiles

php ./make-versions.php

Build a single image images with

bash ./build-image.sh 8.0