trafex/php-nginx repository overview

⁠Docker PHP-FPM 8.5 & Nginx 1.28 on Alpine Linux

Example PHP-FPM 8.5 & Nginx 1.28 container image for Docker, built on Alpine Linux⁠.

Repository: https://github.com/TrafeX/docker-php-nginx⁠

• Built on the lightweight and secure Alpine Linux distribution
• Multi-platform, supporting AMD4, ARMv6, ARMv7, ARM64
• Very small Docker image size (+/-40MB)
• Uses PHP 8.5 for the best performance, low CPU usage & memory footprint
• Optimized for 100 concurrent users i.e. limits the concurrent requests serving php files
• Optimized to only use resources when there's traffic (by using PHP-FPM's on-demand process manager)
• The services Nginx, PHP-FPM and supervisord run under a non-privileged user (nobody) to make it more secure
• The logs of all the services are redirected to the output of the Docker container (visible with docker logs -f <container name>)
• Follows the KISS principle (Keep It Simple, Stupid) to make it easy to understand and adjust the image to your needs

I can help you with Containerization, Kubernetes, Monitoring, Infrastructure as Code and other DevOps challenges⁠.

⁠Goal of this project

The goal of this container image is to provide an example for running Nginx and PHP-FPM in a container which follows the best practices and is easy to understand and modify to your needs.

⁠Usage

Start the Docker container:

docker run -p 80:8080 trafex/php-nginx

See the PHP info on http://localhost⁠, or the static html page on http://localhost/test.html⁠

Or mount your own code to be served by PHP-FPM & Nginx

docker run -p 80:8080 -v ~/my-codebase:/var/www/html trafex/php-nginx

⁠Versioning

This image follows semantic versioning;

• latest - Latest stable release (automatically updated weekly with the latest patches from Alpine Linux)
• <major>.<minor>.<patch> - Specific immutable version (e.g., 3.9.1, 3.9.2)
• <major>.<minor> - Latest patch version for a minor release (e.g., 3.9 → 3.9.2)
• <major> - Latest minor and patch version (e.g., 3 → 3.9.2)

⁠Configuration

In config/⁠ you'll find the default configuration files for Nginx, PHP and PHP-FPM. If you want to extend or customize that you can do so by mounting a configuration file in the correct folder;

Nginx configuration:

docker run -v "`pwd`/nginx-server.conf:/etc/nginx/conf.d/server.conf" trafex/php-nginx

PHP configuration:

docker run -v "`pwd`/php-setting.ini:/etc/php85/conf.d/settings.ini" trafex/php-nginx

PHP-FPM configuration:

docker run -v "`pwd`/php-fpm-settings.conf:/etc/php85/php-fpm.d/server.conf" trafex/php-nginx

Note; Because -v requires an absolute path I've added pwd in the example to return the absolute path to the current directory

⁠Documentation and examples

To modify this container to your specific needs please see the following examples;

• Adding xdebug support⁠
• Adding composer⁠
• Getting the real IP of the client behind a load balancer⁠
• Sending e-mails⁠