PHP-FPM on Alpine with common extensions for reverse-proxy setups.
6.5K
| Repository | Link |
|---|---|
| GitHub | https://github.com/tackleza/docker-php-fpm-ext |
| Docker Hub | https://hub.docker.com/r/tackleza/php-fpm-ext |
A PHP-FPM image with a curated set of common extensions pre-installed.
This image does not include a web server. It only provides PHP-FPM. You must pair it with a frontend web server (Nginx, Caddy, Apache with mod_proxy_fcgi, etc.).
For a standalone PHP + Apache server, use tackleza/php-apache-ext instead.
| Tag | PHP Version | Base |
|---|---|---|
8.2-alpine | PHP 8.2 | Alpine Linux |
8.3-alpine | PHP 8.3 | Alpine Linux |
8.4-alpine | PHP 8.4 | Alpine Linux |
8.5-alpine | PHP 8.5 | Alpine Linux |
latest | PHP 8.5 | Alpine Linux |
PHP 8.6 is a release candidate and is not intended for production. PHP 8.1 has been dropped (EOL).
The supported tags (8.2-alpine, 8.3-alpine, 8.4-alpine, 8.5-alpine, and latest) are rebuilt from official PHP images containing the fixes for CVE-2026-109618 and CVE-2026-109619. The release build checks the PHP version, installed extensions, and PHP-FPM configuration before publication.
| Tag | Fixed PHP version |
|---|---|
8.2-alpine | 8.2.35 |
8.3-alpine | 8.3.36 |
8.4-alpine | 8.4.27 |
8.5-alpine, latest | 8.5.12 |
Pull the updated tag and recreate your containers to use the fixed runtime. Existing running containers do not update automatically. You can check a pulled image with docker run --rm --entrypoint php tackleza/php-fpm-ext:8.5-alpine -r 'echo PHP_VERSION, PHP_EOL;'.
Supported images install external extensions with PHP PIE, pinned to version 1.5.2. Imagick 3.8.1, MongoDB 2.5.5, and Redis 6.3.0 come from version-pinned packages on Packagist. PHP 8.4 and 8.5 also install the maintained IMAP package sirlouen/imap 1.1.2 through PIE; PHP 8.2 and 8.3 use their bundled IMAP extension. Other bundled extensions continue to use install-php-extensions.
Extension versions are intentionally pinned for repeatable builds. A PIE release or package update requires a new image build and validation; existing containers must be recreated after pulling an updated tag.
| Extension | Description |
|---|---|
bcmath | Arbitrary precision mathematics |
bz2 | Bzip2 compressed file support |
calendar | Calendar conversion |
exif | EXIF metadata in images |
gd | Image creation and manipulation |
gettext | Native language support (GNU gettext) |
gmp | GNU Multiple Precision arithmetic |
imagick | ImageMagick integration |
imap | IMAP email protocol support |
intl | Internationalization (ICU) |
mongodb | MongoDB driver |
mysqli | MySQL Improved extension |
opcache | PHP bytecode cache |
pcntl | Process control |
pdo_mysql | PDO MySQL driver |
redis | Redis in-memory data store client |
shmop | Shared memory operations |
soap | SOAP protocol support |
sockets | Low-level socket interface |
sysvmsg | System V message queues |
sysvsem | System V semaphores |
sysvshm | System V shared memory |
tidy | HTML/XML cleaner and repairer |
xsl | XSLT transformations |
zip | ZIP archive support |
1. Start the PHP-FPM container:
docker run -d \
--name php-fpm \
-v $(pwd)/data:/var/www/html \
tackleza/php-fpm-ext:8.3-alpine
2. Add Nginx configuration:
server {
listen 80;
server_name example.com;
root /var/www/html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass php-fpm:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
services:
nginx:
image: nginx:alpine
ports:
- "8080:80"
volumes:
- ./data:/var/www/html
- ./nginx.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php
php:
image: tackleza/php-fpm-ext:8.3-alpine
volumes:
- ./data:/var/www/html
- ./custom-php.ini:/usr/local/etc/php/conf.d/custom-php.ini
Mount your own .ini file to override or add PHP settings:
-v $(pwd)/custom-php.ini:/usr/local/etc/php/conf.d/custom-php.ini
Example custom-php.ini:
memory_limit = 512M
upload_max_filesize = 512M
post_max_size = 512M
The container automatically remaps www-data to match the UID/GID of whoever owns the mounted /var/www directory. No manual chown needed — PHP-FPM can write files and the host user retains full access for git pull, deploy scripts, and live code editing.
| Scenario | Behavior |
|---|---|
Mount from /home/user_a (uid=1000) | www-data remapped to uid=1000 |
Mount from /home/user_b (uid=1001) | www-data remapped to uid=1001 |
Mount from /root (uid=0) | No remapping (root owns everything) |
To override the detected UID/GID explicitly:
docker run -e FPM_UID=$(id -u) -e FPM_GID=$(id -g) \
-v $(pwd)/data:/var/www/html \
tackleza/php-fpm-ext:8.3-alpine
| Version | Status | EOL Date |
|---|---|---|
| PHP 8.1 | ❌ Dropped | Nov 2025 |
| PHP 8.2 | ✅ Active | Dec 2026 |
| PHP 8.3 | ✅ Active | Dec 2027 |
| PHP 8.4 | ✅ Active | Dec 2028 |
| PHP 8.5 | ✅ Active | Dec 2029 |
Content type
Image
Digest
sha256:b6318ea51…
Size
91.2 MB
Last updated
about 1 month ago
docker pull tackleza/php-fpm-ext