PHP-FPM 5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2 Docker image with most popular extensions and tools
This image adds common things that I usually need to the official php (fpm) image. See that repo for basic usage.
In my journey with Docker, I wrote my own Docker image for PHP-FPM 5.3, PHP-FPM 7.2 and other projects. But I need more PHP-FPM Docker images for many PHP versions than I currently have. So I searched for a solution similiar to official PHP Docker Images but less complex and headache to add extensions and tools. I finally found Helder's docker-php and fall in love with it. Hence, I forked it and add some more customs that I need and everyone also needs.
- PHP 8.2
- PHP 8.1
- PHP 8.0
- PHP 7.4
- PHP 7.3
- PHP 7.2
- PHP 7.1
- PHP 7.0
- PHP 5.6
- PHP 5.5
- PHP 5.4
- PHP 5.3
I welcome all pull requests and any feedback to make this project go further and be more useful to everyone. It's my pleasure to see everyone find this project helpful to them.
- Helder Correia: https://github.com/helderco/docker-php. I forked his repository.
- Filip Procházka: I got the idea of a separated composer.ini for Composer.
- [ List your name here ]
-
PHP
- gd
- intl
- imagick (newly added on Rp70/docker-php)
- mbstring
- mcrypt
- mysqli
- opcache (newly added on Rp70/docker-php, it was named ZendOpcache in PHP 5.2-5.5)
- pdo_mysql
- zip
-
PECL
- memcached (newly added on Rp70/docker-php)
- uploadprogress (Not tested yet by Rp70, other web servers and PHP-FPM are not yet supported as mentioned by author)
- xdebug (disabled by default)
- gosu
- ssmtp
- composer with a separated .ini
- git
- rsync
- unzip
- imagemagick
- ghostscript
See the Dockerfile for examples on how to use these:
apt-install: installs packages and cleans up afterwardsapt-purge: uninstalls packagesdocker-php-pecl-install: usespecl install <package>but adds theextension.inifile for you automatically and cleans up afterwards
Added some common options.
Copy of prod.ini:
/usr/local/etc/php/prod.ini: production settings/usr/local/etc/php/dev.ini: development settings
To use development settings, set ENVIRONMENT=dev.
- Changed process manager to
ondemand; - Silenced access logs;
This configuration file is dedicated to Composer. Thanks fprochazka for the idea.
The entrypoint runs scripts in /docker-entrypoint-init.d/*.sh. Add your own init scripts there or remove existing ones.
Use ENVIRONMENT=dev for development settings (in php.ini).
When mounting a volume from the host to a container, the container sees the host's owner for the files, even if it doesn't exist in the container. This image has a feature that allows setting an environment variable (MAP_WWW_UID) to use a directory and get www-data to have the same uid and gid as the owner of that directory. It defaults to the current working dir, or set to no to disable.
This is useful for example if you're using some tooling in the container to generate files inside the host volume. If this is not used, the host will have files with uid=33 gid=33 or uid=0 gid=0, depending if you're using the www-data user or root.
Note that the container must be run as root, for the permission to change the www-data uid and gid.
Use gosu to run a command as www-data in order to use the mapped ownership.
$ # by default the current dir is used to change www-data's uid
$ docker run -it --rm -v $PWD:/usr/src/app -w /usr/src/app rp70/php-fpm gosu www-data id
uid=1000(www-data) gid=1000(www-data) groups=1000(www-data)
$ # but you can specify another one
$ docker run -it --rm -e MAP_WWW_UID=/data -v $PWD:/data rp70/php-fpm gosu www-data id
uid=1000(www-data) gid=1000(www-data) groups=1000(www-data)
$ # or disable it by setting MAP_WWW_UID=no
$ docker run -it --rm -e MAP_WWW_UID=no -v $PWD:/data -w /data rp70/php-fpm gosu www-data id
uid=33(www-data) gid=33(www-data) groups=33(www-data)
You can change the default listen value by using variables LISTEN_ADDRESS and LISTEN_MODE. The latter is used only when using a socket, and defaults to the value 0666.
$ docker run -it --rm rp70/php-fpm grep listen /usr/local/etc/php-fpm.d/zz-docker.conf
listen = [::]:9000
$ docker run -it --rm -e 'LISTEN_ADDRESS=[::]:3000' rp70/php-fpm grep listen /usr/local/etc/php-fpm.d/zz-docker.conf
listen = [::]:3000
$ docker run -it --rm -e LISTEN_ADDRESS=/var/run/project.sock rp70/php-fpm grep listen /usr/local/etc/php-fpm.d/zz-docker.conf
listen = /var/run/project.sock
listen.mode = 0666
The image comes with an entrypoint that checks for a socket in /var/run/rsyslog/dev/log. If it exists, it will symlink /dev/log to it. This is useful to send logs to syslog.
$ docker run -d --name syslog helder/rsyslog
$ docker run -it --rm --volumes-from syslog rp70/php-fpm logger -p local1.notice "This is a notice!"
$ docker logs syslog
If you would like to check for another location, set the environment variable DEV_LOG_TARGET.
This is a neat feature. By default, this image will send any email to an SMTP host mail and
port 1025. So if you use mailhog/mailhog and link a container with this image to that, you'll
catch all the emails sent by your application in mailhog.
Run mailhog process:
docker run -d -p 8025:8025 --name mail mailhog/mailhog
Send email:
docker run -it --rm --link mail rp70/php-fpm php -r 'mail("to@address.com", "Test", "Testing!", "From: my@example.com");'
Open your browser at http://localhost:8025 to see your emails.
To use other settings, override in your Dockerfile:
FROM rp70/php-fpm
RUN COPY ssmtp.conf /etc/ssmtp/ssmtp.conf
The default timezone is set with TIMEZONE=UTC. Change it with an environment variable.
The XDebug extension is installed but disabled by default. To enable, set the enviroment variable USE_XDEBUG=true.
You can tweak performance or debug using an environment variable. The below environment variables use default settings. You can adjust them to fit your needs.
PHP-FPM: pm.max_children set with PHPFPM_MAX_CHILDREN=5.
PHP-FPM: pm.max_requests set with PHPFPM_MAX_REQUESTS=0.
DOCKER: STARTUP_DEBUG=[yes|no; default=no] to enforce entrypoint script to print executed commands.
- Usage instructions.
- List of supported extensions.
- ENV variables to enable extensions on demand.
- Remove nginx from image.
- Support custom data serializer: https://github.com/igbinary/igbinary and https://github.com/msgpack/msgpack-php to save memory requirement with memcached and custom session handler.
- Support Memcached version replacement as described at https://github.com/php-memcached-dev/php-memcached
- Support Xdebug version replacement as described at https://xdebug.org/docs/compat