phpdockerio/php repository overview

⁠PHPDocker.io base images

Repository of base images for PHPDocker.io⁠ generated environments.

Images are built daily⁠ in order to fetch the latest base image changes as well as available php versions.

⁠NGINX with PageSpeed

More info on its own readme⁠

⁠PHP

⁠Supported architectures

• linux/amd64
• linux/arm64
• linux/arm/v7

⁠OS Base images & PHP Package Sources

All images use an Ubuntu LTS release as base image, except for PHP5.6 which uses Debian Jessie. For each of these base OS images, we use a third party source for the PHP packages - these packages come from Ondřej Surý⁠ who is the official maintainer for PHP in Debian which is the origin of all packages in Ubuntu.

In most cases, we override Ubuntu's PHP packages with Ondřej's to ensure we always have the very latest. For instance, Ubuntu 20.04 comes with php 7.4.3 but we still install Ondřej's packages to ensure you get the absolutest latest version of php 7.4 every time. Ubuntu backport security fixes, but not necessarily bugfixes from later patch releases.

⁠Image types

For each minor PHP version (MAJOR.MINOR) we have a cli and an fpm variant. These two are identical, except for the fact the fpm contains php-fpm and their default command is of course php-fpm.

The images do not define an ENTRYPOINT, instead they define a CMD - this is to make it easier for you to define your own entrypoint that does stuff before running the CMD.

⁠Note on swoole variants

We also used to offer a swoole variant on some images. We have phased these out, as the images were created before we could reliably install the extension via apt and we had to compile it from source. It is now available as an apt package and all you need to do is install it.

⁠Built-in php extensions

• apcu & apcu-bc
• curl
• json (from 8.0, part of php core)
• mbstring
• opcache
• readline
• xml
• zip

These are the minimum extensions I consider necessary for any modern PHP app. They're required by the likes of composer, the symfony/* libraries etc.

⁠Composer

All images use the composer v2. If for whatever reason you need to roll back to v1, add the following to your Dockerfile

COPY --from=composer:1 /usr/bin/composer /usr/bin/composer

⁠Available images:

Notes:

• Versions past EOL (end of life) are unsupported, but may still get daily builds to ensure the underlying OS packages are up to date.
• Daily builds are turned off for versions that run on an OS base that's also EOL (for instance, Debian Jessie).
• Daily builds are kept for PHP versions that have reached EOL but the base OS has not - the base OS still receives security updates, including the PHP runtime.
• In general, do not use any unsupported images in a production environment, regardless of whether daily builds are still enabled. I continue to build these for absolute holdouts that haven't been able to upgrade on time.
• Old images are kept in docker hub in the interest of enabling legacy apps to run. Docker does delete images that haven't been accessed for 6 months. If this happens, I won't be restoring them - you'll need to upgrade.