Nginx/PHP-FPM Docker Image

A lightweight, production-ready, combined Nginx/PHP-FPM Docker image.

Features

The following features work out of the box without any configuration:

• bcmatch is installed for math/currency functionality
• composer is installed for all your PHP dependencies
• gd is installed for image processing
• intl is installed for internationalization and localization support
• msmtp is installed and configured (see config/msmtprc) out of the box to send email to Mailtrap.
  • Logs located at /var/log/msmtp.log
• mysql_pdo is installed as the driver for database connections
• Nginx serves as the web host and reverse proxy
  • Logs located at /var/log/nginx/
• npm and node are installed for all your Node dependencies and scripts
• pcntl is installed for process control (eg: Laravel Horizon)
• PHP-FPM/OPcache for fast performance in the browser and on the CLI
• Redis extension is installed for caching
• supervisord is installed for process management (Starting with image version 32)
  • By default, supervisor starts php-fpm and nginx
  • Place any additional supervisord config in /etc/supervisord/conf.d/*.conf
  • Logs located at /var/log/supervisord.log
• zip is installed for items that may need it (eg: Laravel, CSV/Excel)

Platforms

This image offers platform support for the following architectures starting from image version 8:

• linux/amd64
• linux/arm/v7
• linux/arm64

Install

# Dockerfile
FROM: justintime50/nginx-php:latest

# docker-compose
image: justintime50/nginx-php:latest

Usage

docker compose up -d

Once the container spins up, navigate to http://localhost:8888 in a browser.

Vanilla PHP and HTML

Place your PHP or HTML site files into /var/www/html/public inside the container to get started with this image. This can be achieved by using a volume in a docker-compose file or by copying them over in a Dockerfile. If you are using HTML instead of PHP, ensure you remove the index.php file so that your index.html file can take priority.

Laravel

Place the root of your laravel project in /var/www/html so that the public folder of laravel lines up with the directory served by this nginx image.

Docker Tags

Tags for this image follow the syntax of PHP_VERSION-IMAGE_VERSION; for instance, a valid tag would be 8.2-16 signifying to use PHP v8.2 and the 16th version of this image (nginx config, Dockerfile, etc).

PHP Versions

• 8.4 - uses the latest release on the PHP 8.4 Alpine track. (Starting with image version 21)
• 8.3 - uses the latest release on the PHP 8.3 Alpine track. (Starting with image version 18)
• 8.2 - uses the latest release on the PHP 8.2 Alpine track. (Starting with image version 12)
• 8.1 - uses the latest release on the PHP 8.1 Alpine track. (Starting with image version 9)
• 8.0 - DEPRECATED uses the latest release on the PHP 8.0 Alpine track. (Dropped support with image version 19)
• 7.4 - DEPRECATED uses the latest release on the PHP 7.4 Alpine track. (Dropped support with image version 19)

Image Versions

See the CHANGELOG or the releases page for more details.

Standalone Tags

• latest - uses the latest release (main branch) of this image with all defaults.
• dev - the testing branch for this image. Do not use this tag in production.

Development

Note: Alpine Linux does not keep old versions of packages. This image pins to the relative major version to try staying flexibile. Future builds may need to be altered if packages are no longer offered.

# Test nginx configuration
nginx -T

Releasing

When releasing this project, cut a new GitHub tag/release that iterates the whole-number used (eg: 4, 5, 6, etc). We won't use semver here for simplicity when tagging images.

If you are adding a new PHP version, make sure to add it to the list in the GitHub Workflow files.

Building New Versions

This image supports swapping in the version number of PHP with a value from the official PHP-FPM Alpine tag list.

Automated Builds

GitHub Actions will automatically build and push supported tags to Docker Hub on each new release. Additionally GitHub Actions will automatically build the latest tag on any push to the main branch. It is highly recommended that you use a versioned release of this image to avoid any transient changes introduced in any given latest build.

Manual Builds

docker build -t justintime50/nginx-php:8.0-7 --build-arg PHP_VERSION=8.0 .

sudo docker push justintime50/nginx-php:8.0-7

msmtp (Mail Client)

msmtp is configured to work with Mailtrap out of the box. There is also a gmail template that you can uncomment and use in production. Spin up this container, then run the following to send mail directly with msmtp:

echo -e "Subject: Test email from msmtp\r\n\r\nThis is a test email direct from msmtp" |msmtp --debug --from from@example.com -t to@example.com

You can also send mail with PHP which routes the emails through msmtp:

php -r "mail('to@example.com','Test email from PHP', 'This is a test email from PHP');"