Skip to content

README.md

Latest commit

 

History

History
84 lines (58 loc) · 3.12 KB

README.md

File metadata and controls

84 lines (58 loc) · 3.12 KB

PHP application server

This image provides ready to go application server based on Alpine, Nginx and PHP-FPM. Container main process is runit process. Also in the image we have some preinstalled apps: composer, git, openssh, runit, bash and self-signed keys for Nginx.

Usage

To run this docker-compose below you should create .env file and create APP_HTTP_PORT and APP_HTTPS_PORT variables.

services:
    app:
        image: mgdteam/php:8.4-fpm-nginx
        ports:
            - 127.0.0.1:${APP_HTTP_PORT}:80
            - 127.0.0.1:${APP_HTTPS_PORT}:443
        volumes:
            - ./app:/var/www/app:cached
        
    queue-worker:
        image: mgdteam/php:8.4-cli
        volumes:
            - ./app:/var/www/app:cached
        # Command can be run in container periodically
        # Command format: /entrypoint.cmd.sh <command> <run-interval-in-seconds>
        # Example: command: bin/console messenger:consume async -vv

Customize PHP and Nginx configuration

To configure PHP and Nginx you should create new Dockerfile and override config files to your own. Dockerfile example:

FROM mgdteam/php:8.4-fpm-nginx

# Change php configuration
ADD ./php/php.ini "$PHP_INI_DIR/conf.d/my-custom.ini"

# Change nginx configuration
ADD ./nginx/nginx.conf /etc/nginx/nginx.conf

# Change nginx vhosts configuration
ADD ./nginx/default.conf /etc/nginx/conf.d/default.conf

Run additional services inside the container

The PHP-FPM container has runit on board. To run a user service with runit need to create a run script and copy it according to the example below. Example of a run script (e.g. ./php/runit/messenger-worker/run) to start a user service (e.g. Symfony messenger consumer):

#!/usr/bin/env sh
php /var/www/app/bin/console messenger:consume async

Copy this script during Dockerfile building to the predefined runit services folder:

RUN mkdir -p "/run/messenger-worker"
RUN mkdir -p "$SERVICE_AVAILABLE_DIR/messenger-worker*"
COPY ./php/runit/messenger-worker/run "$SERVICE_AVAILABLE_DIR/messenger-worker/run"
RUN chmod +x "$SERVICE_AVAILABLE_DIR/messenger-worker/run"
RUN ln -s "$SERVICE_AVAILABLE_DIR/messenger-worker" ${SERVICE_ENABLED_DIR}

So the run script will be demonized and started in a separate process during container running.

How to build/push an image

Docker CLI with buildx plugin should be installed to build a Docker image. There is a build script tu build and push a new Docker image to the registry:

./build.sh <PHP_VERSION> <ENVIRONMENT>

Available PHP versions: 8.0, 8.1, 8.2, 8.3, 8.4, 8.5.

Available environments: development, production. The environment defines a PHP configuration which should be used. This configuration contains performance optimizations according to Symfony docs.