99 lines
4.0 KiB
Markdown
99 lines
4.0 KiB
Markdown
# Docker PHP-FPM 8.0 & Nginx 1.20 on Alpine Linux
|
|
Example PHP-FPM 8.0 & Nginx 1.20 container image for Docker, build 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.0 for better performance, lower 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/)
|
|
|
|
|
|
|
|
|
|
## 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
|
|
|
|
### Docker Hub repository name change
|
|
Since we switched to PHP8 the repository name [trafex/alpine-nginx-php7](https://hub.docker.com/r/trafex/alpine-nginx-php7) didn't make sense anymore.
|
|
Because you can't change the name of the repository on Docker Hub I created a new one.
|
|
|
|
From now on this image can be pulled from Docker Hub under the name [trafex/php-nginx](https://hub.docker.com/r/trafex/php-nginx).
|
|
|
|
## 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/php8/conf.d/settings.ini" trafex/php-nginx
|
|
|
|
PHP-FPM configuration:
|
|
|
|
docker run -v "`pwd`/php-fpm-settings.conf:/etc/php8/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_
|
|
|
|
|
|
## Adding composer
|
|
|
|
If you need [Composer](https://getcomposer.org/) in your project, here's an easy way to add it.
|
|
|
|
```Dockerfile
|
|
FROM trafex/php-nginx:latest
|
|
|
|
# Install composer from the official image
|
|
COPY --from=composer /usr/bin/composer /usr/bin/composer
|
|
|
|
# Run composer install to install the dependencies
|
|
RUN composer install --optimize-autoloader --no-interaction --no-progress
|
|
```
|
|
|
|
### Building with composer
|
|
|
|
If you are building an image with source code in it and dependencies managed by composer then the definition can be improved.
|
|
The dependencies should be retrieved by the composer but the composer itself (`/usr/bin/composer`) is not necessary to be included in the image.
|
|
|
|
```Dockerfile
|
|
FROM composer AS composer
|
|
|
|
# copying the source directory and install the dependencies with composer
|
|
COPY <your_directory>/ /app
|
|
|
|
# run composer install to install the dependencies
|
|
RUN composer install \
|
|
--optimize-autoloader \
|
|
--no-interaction \
|
|
--no-progress
|
|
|
|
# continue stage build with the desired image and copy the source including the
|
|
# dependencies downloaded by composer
|
|
FROM trafex/php-nginx
|
|
COPY --chown=nginx --from=composer /app /var/www/html
|
|
```
|