https://github.com/adhocore/docker-phpfpm
Lightweight (~100mb) Docker PHP FPM for both arm and amd arch on alpine 3.17+ with PHP8.0.30/8.1.29/8.2.23/8.3.11 (also 7.4.33) with ~80-84 useful extensions (you can disable not necessary ones easily)
https://github.com/adhocore/docker-phpfpm
adhocore alpine alpine-linux container docker docker-php-74 docker-php-fpm hacktoberfest php php-74 php-docker php-docker-image php-docker-stack php-extensions php8 php83 phpfpm
Last synced: 3 months ago
JSON representation
Lightweight (~100mb) Docker PHP FPM for both arm and amd arch on alpine 3.17+ with PHP8.0.30/8.1.29/8.2.23/8.3.11 (also 7.4.33) with ~80-84 useful extensions (you can disable not necessary ones easily)
- Host: GitHub
- URL: https://github.com/adhocore/docker-phpfpm
- Owner: adhocore
- License: mit
- Created: 2019-02-03T02:52:21.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-12-14T00:05:19.000Z (6 months ago)
- Last Synced: 2025-03-29T09:11:42.454Z (3 months ago)
- Topics: adhocore, alpine, alpine-linux, container, docker, docker-php-74, docker-php-fpm, hacktoberfest, php, php-74, php-docker, php-docker-image, php-docker-stack, php-extensions, php8, php83, phpfpm
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/adhocore/phpfpm
- Size: 223 KB
- Stars: 100
- Watchers: 2
- Forks: 33
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
## docker-phpfpm
[](https://github.com/adhocore/docker-phpfpm/actions/workflows/build.yml)
[](https://twitter.com/intent/tweet?text=Production+ready+PHP7+and+PHP8+docker+images+with+plenty+extensions&url=https://github.com/adhocore/docker-phpfpm&hashtags=docker,dockerimage,php7,php8,phpext)
[](https://github.com/sponsors/adhocore)
**Important Note**: To be able to support arm builds ([#81](https://github.com/adhocore/docker-phpfpm/issues/81)) we removed some big and slow to compile extensions like swoole/grpc/phalcon for now.
Check [example](#extensions) below how to add them back in your images based off on `adhcore/phpfpm`.
Docker PHP FPM with lean alpine base. The download size is just about **~100MB** - tiny given how many extensions it has baked in.
It contains PHP>=8.4.1, PHP>=8.3.4, PHP>=8.2.17, PHP>=8.1.27 and PHP>=8.0.30 with plenty of common and useful extensions.
If you are looking for a complete local development stack then check
[`adhocore/lemp`](https://github.com/adhocore/docker-lemp).
The images are always latest, everytime a new PHP version comes out and its official image is available we will see it in adhocore/phpfpm the next day.
> This repo is looking for maintainer (start a thread in [#101](https://github.com/adhocore/docker-phpfpm/issues/101) if interested)
## Usage
To pull latest image:
```sh
# for php >=8.4.1
docker pull adhocore/phpfpm:8.4
# for php >=8.3.4
docker pull adhocore/phpfpm:8.3
# for php >=8.2.17
docker pull adhocore/phpfpm:8.2
# or for php >=8.1.27
docker pull adhocore/phpfpm:8.1
# or for php >=8.0.30
docker pull adhocore/phpfpm:8.0
# or for php >=8.3rc5 (release candidate)
docker pull adhocore/phpfpm:8.3r
# or for php >=7.4 (end of life)
docker pull adhocore/phpfpm:7.4
```
To use in docker-compose
```yaml
# ./docker-compose.yml
version: '3'
services:
phpfpm:
image: adhocore/phpfpm:8.3
container_name: phpfpm
volumes:
- ./path/to/your/app:/var/www/html
# Here you can also volume php ini settings
# - /path/to/zz-overrides:/usr/local/etc/php/conf.d/zz-overrides.ini
ports:
- 9000:9000
environment:
# ...
```
### Composer
Latest versions of both Composer v1 and v2 are installed already. You can run v2 with `composer` and v1 with `composer1`.
### Extensions
You can add new extensions in your image like so:
```Dockerfile
FROM adhocore/phpfpm:8.4 # or 8.3, 8.2
RUN \
# setup
apk add -U $PHPIZE_DEPS \
#
# if it is in pecl: \
&& docker-pecl-ext-install grpc phalcon swoole \
&& apk del $PHPIZE_DEPS \
#
# if it is in php ext: \
&& docker-php-source extract && docker-php-ext-install-if dba \
&& docker-php-source delete
```
Debug extension `xdebug` is installed but disabled by default for performance reason,
just run `docker-php-ext-enable xdebug` to enable it again without having to rebuild/recompile.
> `docker-php-ext-install-if` is like the inbuilt `docker-php-ext-install` but a little better, because this one installs extensions only if really needed i.e. not installed at all (so even disabled extensions need not to be installed all over again).
Below you can find list of extensions by image tags.
### PHP8.4
```
PHP 8.4.1, Total extensions: 60
- bcmath - bz2 - calendar - core
- ctype - curl - date - dom
- exif - fileinfo - filter - fpm
- ftp - gd - gettext - gmp
- hash - iconv - imap - intl
- json - ldap - libxml - mbstring
- mysqli - mysqlnd - openssl - pcntl
- pcre - pdo - pdo_mysql - pdo_pgsql
- pdo_sqlite - pgsql - phar - posix
- pspell - random - readline - reflection
- session - shmop - simplexml - soap
- sodium - spl - sqlite3 - standard
- sysvmsg - sysvsem - sysvshm - tidy
- tokenizer - xdebug - xml - xmlreader
- xmlwriter - xsl - zip - zlib
```
### PHP8.3
```
PHP 8.3.4, Total extensions: 60
- bcmath - bz2 - calendar - core
- ctype - curl - date - dom
- exif - fileinfo - filter - fpm
- ftp - gd - gettext - gmp
- hash - iconv - imap - intl
- json - ldap - libxml - mbstring
- mysqli - mysqlnd - openssl - pcntl
- pcre - pdo - pdo_mysql - pdo_pgsql
- pdo_sqlite - pgsql - phar - posix
- pspell - random - readline - reflection
- session - shmop - simplexml - soap
- sodium - spl - sqlite3 - standard
- sysvmsg - sysvsem - sysvshm - tidy
- tokenizer - xdebug - xml - xmlreader
- xmlwriter - xsl - zip - zlib
```
#### PHP8.2
The following PHP extensions are installed in `adhocore/phpfpm:8.2`:
```
PHP >=8.2.17, Total extensions: 82
- apcu - ast - bcmath - bz2
- calendar - core - ctype - curl
- date - dom - ds - ev
- exif - fileinfo - filter - fpm
- ftp - gd - gettext - gmp
- hash - iconv - igbinary - imagick
- imap - intl - json - ldap
- libxml - lzf - mbstring - memcached
- mongodb - msgpack - mysqli - mysqlnd
- oauth - openssl - pcntl - pcov
- pcre - pdo - pdo_mysql - pdo_pgsql
- pdo_sqlite - pgsql - phar - posix
- pspell - psr - random - rdkafka
- readline - redis - reflection - session
- shmop - simdjson - simplexml - soap
- sodium - spl - sqlite3 - ssh2
- standard - sysvmsg - sysvsem - sysvshm
- tidy - tokenizer - uuid - xdebug
- xhprof - xlswriter - xml - xmlreader
- xmlwriter - xsl - yaml - zend opcache
- zip - zlib
```
#### PHP8.1
The following PHP extensions are installed in `adhocore/phpfpm:8.1`:
```
PHP >=8.1.27, Total extensions: 83
- apcu - ast - bcmath - bz2
- calendar - core - ctype - curl
- date - dom - ds - ev
- exif - fileinfo - filter - fpm
- ftp - gd - gettext - gmp
- hash - iconv - igbinary - imagick
- imap - intl - json - ldap
- libxml - lzf - mbstring - memcached
- mongodb - msgpack - mysqli - mysqlnd
- oauth - openssl - pcntl - pcov
- pcre - pdo - pdo_mysql - pdo_pgsql
- pdo_sqlite - pgsql - phar - posix
- pspell - psr - rdkafka - readline
- redis - reflection - session - shmop
- simdjson - simplexml - soap - sockets
- sodium - spl - sqlite3 - ssh2
- standard - sysvmsg - sysvsem - sysvshm
- tidy - tokenizer - uuid - xdebug
- xhprof - xlswriter - xml - xmlreader
- xmlwriter - xsl - yaf - yaml
- zend opcache - zip - zlib
```
#### PHP8.0
The following PHP extensions are installed in `adhocore/phpfpm:8.0`:
```
PHP >=8.0.30, Total extensions: 84
- apcu - ast - bcmath - bz2
- calendar - core - ctype - curl
- date - dom - ds - ev
- exif - fileinfo - filter - fpm
- ftp - gd - gettext - gmp
- hash - iconv - igbinary - imagick
- imap - intl - json - ldap
- libxml - lzf - mbstring - memcached
- mongodb - msgpack - mysqli - mysqlnd
- oauth - openssl - pcntl - pcov
- pcre - pdo - pdo_mysql - pdo_pgsql
- pdo_sqlite - pgsql - phalcon - phar
- posix - pspell - psr - rdkafka
- readline - redis - reflection - session
- shmop - simdjson - simplexml - soap
- sockets - sodium - spl - sqlite3
- ssh2 - standard - sysvmsg - sysvsem
- sysvshm - tidy - tokenizer - uuid
- xdebug - xhprof - xlswriter - xml
- xmlreader - xmlwriter - xsl - yaf
- yaml - zend opcache - zip - zlib
```
#### PHP7.4
The following PHP extensions are installed in `adhocore/phpfpm:7.4`:
```
PHP >=7.4.33, Total extensions: 82
- apcu - ast - bcmath - bz2
- calendar - core - ctype - curl
- date - dom - ds - ev
- exif - fileinfo - filter - fpm
- ftp - gd - gettext - gmp
- hash - hrtime - iconv - igbinary
- imagick - imap - intl - json
- ldap - libxml - lua - lzf
- mbstring - memcached - mongodb - msgpack
- mysqli - mysqlnd - oauth - openssl
- pcntl - pcov - pcre - pdo
- pdo_mysql - pdo_pgsql - pdo_sqlite - pgsql
- phar - posix - psr - rdkafka
- readline - redis - reflection - session
- simdjson - simplexml - soap - sockets
- sodium - spl - sqlite3 - ssh2
- standard - sysvmsg - sysvsem - sysvshm
- tideways_xhprof - tidy - tokenizer - uuid
- xdebug - xlswriter - xml - xmlreader
- xmlwriter - yaf - yaml - zend opcache
- zip - zlib
```
Read more about
[pcov](https://github.com/krakjoe/pcov),
[psr](https://github.com/jbboehr/php-psr)
### Production Usage
For production you may want to get rid of some extensions that are not really required.
In such case, you can build a custom image on top `adhocore/phpfpm:8.4` like so:
```Dockerfile
FROM adhocore/phpfpm:8.4 # or 8.3 or 8.2
# Disable extensions you won't need. You can add as much as you want separated by space.
RUN docker-php-ext-disable xdebug pcov ldap
```
> `docker-php-ext-disable` is shell script available in `adhocore/phpfpm` only and not in official PHP docker images.
> Extensions disabled can be re enabled with `docker-php-ext-enable` later again without the overhead of recompiling/rebuilding all over again.