mirror of
https://github.com/netfun2000/docker-php-nginx.git
synced 2026-04-22 00:29:10 +08:00
70 lines
3.5 KiB
Markdown
70 lines
3.5 KiB
Markdown
# Docker PHP-FPM 8.3 & Nginx 1.24 on Alpine Linux
|
|
Example PHP-FPM 8.3 & Nginx 1.24 container image for Docker, built on [Alpine Linux](https://www.alpinelinux.org/).
|
|
|
|
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.3 for the best performance, low CPU usage & memory footprint
|
|
* Optimized for 100 concurrent users
|
|
* 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
|
|
|
|
[](https://hub.docker.com/r/trafex/php-nginx/)
|
|
|
|
|
|
|
|
|
|
## [](https://timdepater.com?mtm_campaign=github)
|
|
I can help you with [Containerization, Kubernetes, Monitoring, Infrastructure as Code and other DevOps challenges](https://timdepater.com/?mtm_campaign=github).
|
|
|
|
|
|
## 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
|
|
Major or minor changes are always published as a [release](https://github.com/TrafeX/docker-php-nginx/releases) with correspondending changelogs.
|
|
The `latest` tag is automatically updated weekly to include the latests patches from Alpine Linux.
|
|
|
|
## Configuration
|
|
In [config/](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/php83/conf.d/settings.ini" trafex/php-nginx
|
|
|
|
PHP-FPM configuration:
|
|
|
|
docker run -v "`pwd`/php-fpm-settings.conf:/etc/php83/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](https://github.com/TrafeX/docker-php-nginx/blob/master/docs/xdebug-support.md)
|
|
* [Adding composer](https://github.com/TrafeX/docker-php-nginx/blob/master/docs/composer-support.md)
|
|
* [Getting the real IP of the client behind a load balancer](https://github.com/TrafeX/docker-php-nginx/blob/master/docs/real-ip-behind-loadbalancer.md)
|
|
* [Sending e-mails](https://github.com/TrafeX/docker-php-nginx/blob/master/docs/sending-emails.md) |