This image extends the wp-php-fpm image to include additional tools focusing on developing WordPress using wp-local-docker-v2. These tools include git, vim, telnet, strace, wp-cli, nvm/node, composer. It is also configured to capture log output from PHP and log it to stderr.
There are currently a number of images being built for the different operating systems. This image is built using 10up/wp-php-fpm as the base image with support for PHP 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0 and 8.1. They are available under the tags:
- CentOS 7 based
- 10up/wp-php-fpm-dev:5.6
- 10up/wp-php-fpm-dev:7.0
- 10up/wp-php-fpm-dev:7.1
- Rocky Linux 8 based
- 10up/wp-php-fpm-dev:7.2
- 10up/wp-php-fpm-dev:7.3
- 10up/wp-php-fpm-dev:7.4
- 10up/wp-php-fpm-dev:8.0
- Ubuntu 22.04 based
- 10up/wp-php-fpm-dev:7.0-ubuntu
- 10up/wp-php-fpm-dev:7.1-ubuntu
- 10up/wp-php-fpm-dev:7.2-ubuntu
- 10up/wp-php-fpm-dev:7.3-ubuntu
- 10up/wp-php-fpm-dev:7.4-ubuntu
- 10up/wp-php-fpm-dev:8.0-ubuntu
- 10up/wp-php-fpm-dev:8.1-ubuntu
This image runs just php-fpm and expects that files are located at /var/www/html. They can be mounted or copied there using an init container. Running this image might look like this:
docker run -d --name phpfpm \
-v /var/www/html:/var/www/html
10up/wp-php-fpm-dev:8.1-ubuntu
This image is configured with MSMTP for handling email. It can only be configured to talk to an even smarter smart host meaning it cannot be configured with authentication of any sort. To configure MSMTP pass the following environment variables
MAILER_HOST=<your mailer host>MAILER_PORT=<your mailer hosts port>
The entrypoint script will then configure MSMTP properly.
This image contains composer versions 1 and 2. Composer 2 is used by default and to use composer 1, set the COMPOSER_VERSION env var to 1.
Node Version Manager is also installed and ready for use. You may find nvm is difficult to get loaded, be sure you are using a "login" prompt so that the nvm system has been loaded. For bash, this would mean "bash -l" should be called.
Xdebug can be very slow on some systems. By default, xdebug will not be loaded. If you wish to have Xdebug loaded pass an environment variable of ENABLE_XDEBUG=true to enable it.
This project takes advantage of custom build phase hooks as described at https://docs.docker.com/docker-hub/builds/advanced/. When setting up builds on docker hub create automated builds with rules to build for the master branch for each PHP version you want built. Currently this image is built with 5.6, 7.0, 7.1, 7.2, 7.3 and 7.4.
Active: 10up is actively working on this, and we expect to continue work for the foreseeable future including keeping tested up to the most recent version of WordPress. Bug reports, feature requests, questions, and pull requests are welcome.
