Important Note: To be able to support arm builds (#81) we removed some big and slow to compile extensions like swoole/grpc/phalcon for now.
Check example 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.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
.
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 if interested)
To pull latest image:
# 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
# ./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:
# ...
Latest versions of both Composer v1 and v2 are installed already. You can run v2 with composer
and v1 with composer1
.
You can add new extensions in your image like so:
FROM adhocore/phpfpm:8.3 # or 8.2, 8.1
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 inbuiltdocker-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.
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
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
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
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
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
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.2
like so:
FROM adhocore/phpfpm:8.2 # or 8.1 or 8.0
# 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 inadhocore/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.