Lightweight & optimized Multi-Arch Docker Images (x86_64/arm/arm64) for Nginx 1.25.3 & PHP-FPM 8.3) with essential extensions on top of latest Alpine Linux.
Example PHP-FPM 8.3 & Nginx 1.25 container image for Docker, built on Alpine Linux.
Repository: https://github.com/bitscoid/nginx-php
- Built on the lightweight and secure Alpine Linux distribution
- Multi-platform, supporting AMD4, ARMv6, ARMv7, ARM64
- Very small Docker image size (+/-74MB)
- 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-demandprocess 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>)
I can help you with Web & App Development, Containerization, Kubernetes, Monitoring, Infrastructure as Code..
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.
# php -v
PHP 8.3.0 (cli) (built: Nov 30 2023 23:39:07) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.0, Copyright (c) Zend Technologies
with Zend OPcache v8.3.0, Copyright (c), by Zend Technologies
# nginx -v
nginx version: nginx/1.24.0
# php -m
[PHP Modules]
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gd
hash
iconv
igbinary
imap
intl
json
ldap
libxml
mbstring
memcached
msgpack
mysqlnd
openssl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
random
readline
redis
Reflection
session
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
tokenizer
xml
xmlreader
xmlwriter
Zend OPcache
zip
zlib
[Zend Modules]
Zend OPcache
# php -r "echo sprintf(\"GD SUPPORT %s\n\", json_encode(gd_info()));"
GD SUPPORT {"GD Version":"bundled (2.1.0 compatible)","FreeType Support":true,"FreeType Linkage":"with freetype","GIF Read Support":true,"GIF Create Support":true,"JPEG Support":true,"PNG Support":true,"WBMP Support":true,"XPM Support":false,"XBM Support":true,"WebP Support":true,"BMP Support":true,"AVIF Support":false,"TGA Read Support":true,"JIS-mapped Japanese Font Support":false}
Start the Docker container:
docker run -p 80:80 bantenitsolutions/nginx-php
See the PHP info on http://localhost
Or mount your own code to be served by PHP-FPM & Nginx
docker run -p 80:80 -v ~/app:/var/www/bits bantenitsolutions/nginx-php
For example, use this docker image to deploy a Laravel 10 project.
Dockerfile:
FROM bitscoid/nginx-php
# copy source code
COPY . /var/www/bits
# run.sh will replace default web root from /var/www/bits to $WEBROOT
ENV WEBROOT /var/www/bits/public
# run.sh will use redis as session store with docker container name $PHP_REDIS_SESSION_HOST
ENV REDIS_HOST redis
# download required node/php packages,
# some node modules need gcc/g++ to build
RUN cd /var/www/bits \
# install node modules
&& npm install \
# install php composer packages
&& composer install \
# clean
&& npm run dev \
# set .env
&& cp .env.test .env \
# change /var/www/bits user/group
&& chown -Rf nobody:nobody /var/www/bitsYou may check run.sh for more information about what it can do.
Another example to develop with this image for a Laravel 10 project, you may modify the docker-compose.yml of your project.
Make sure you have correct environment parameters set:
# For more information: https://laravel.com/docs/sail
version: '3'
services:
laravel.test:
image: 'bantenitsolutions/nginx-php:latest'
ports:
- '80:80'
environment:
WEBROOT: '/var/www/bits/public'
PHP_MEM_LIMIT: '2048'
PHP_POST_MAX_SIZE: '128'
PHP_UPLOAD_MAX_FILESIZE: '128'
REDIS_HOST: '127.0.0.1'
#RUN_SCRIPTS: '1'
extra_hosts:
- 'host.docker.internal:host-gateway'
volumes:
- './app:/var/www/bits'
networks:
- sail
depends_on:
- mysql
- redis
mysql:
image: 'bantenitsolutions/mariadb-lite:latest'
ports:
- '3306:3306'
restart: 'always'
environment:
MYSQL_USER: 'bits_user'
MYSQL_PASS: 'bits_pass'
MYSQL_NAME: 'bits_name'
volumes:
- './db:/var/lib/mysql'
networks:
- sail
redis:
image: 'redis:alpine'
ports:
- '6379:6379'
volumes:
- 'sail-redis:/data'
networks:
- sail
healthcheck:
test: ["CMD", "redis-cli", "ping"]
retries: 3
timeout: 5s
networks:
sail:
driver: bridgeIn nginx and php directory 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 "./server/nginx/nginx.conf:/etc/nginx/http.d/default.conf" bantenitsolutions/nginx-php
Nginx Default Site:
docker run -v "./server/nginx/http.d/default.conf:/etc/nginx/http.d/default.conf" bantenitsolutions/nginx-php
PHP Configuration:
docker run -v "./server/php/php.ini:/usr/local/etc/php/php.ini" bantenitsolutions/nginx-php
PHP-FPM Configuration:
docker run -v "./server/php/www.conf:/usr/local/etc/php-fpm.d/www.conf" bantenitsolutions/nginx-php
Add extra PHP modules
You may use this image as the base image to build your own. For example, to add mongodb module: Create a Dockerfile
FROM bantenitsolutions/nginx-php
RUN apk add --no-cache --update --virtual .phpize-deps $PHPIZE_DEPS \
&& apk add --no-cache --update --virtual .all-deps $PHP_MODULE_DEPS \
&& pecl install mongodb \
&& docker-php-ext-enable mongodb \
&& rm -rf /tmp/pear \
&& apk del .all-deps .phpize-deps \
&& rm -rf /var/cache/apk/* /tmp/* /var/tmp/*
Build Image
docker build -t my-nginx-php .