Skip to content

Latest commit

 

History

History
204 lines (133 loc) · 7.57 KB

README.md

File metadata and controls

204 lines (133 loc) · 7.57 KB
Raw

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.

About this repo

The story

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 versions

  • 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

Contribution

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.

Contributors

What was added?

Extensions

  • 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)

Tooling

  • gosu
  • ssmtp
  • composer with a separated .ini
  • git
  • rsync
  • unzip
  • imagemagick
  • ghostscript

Scripts

See the Dockerfile for examples on how to use these:

  • apt-install: installs packages and cleans up afterwards
  • apt-purge: uninstalls packages
  • docker-php-pecl-install: uses pecl install <package> but adds the extension.ini file for you automatically and cleans up afterwards

Configuration

/usr/local/etc/php/php.ini

Added some common options.

/usr/local/etc/php/conf.d/environment.ini

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.

/usr/local/etc/php-fpm.d/*.conf

  • Changed process manager to ondemand;
  • Silenced access logs;

/usr/local/etc/php/composer.ini

This configuration file is dedicated to Composer. Thanks fprochazka for the idea.

Entrypoint features

The entrypoint runs scripts in /docker-entrypoint-init.d/*.sh. Add your own init scripts there or remove existing ones.

Development settings

Use ENVIRONMENT=dev for development settings (in php.ini).

UID and GID mapping

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)

Listen

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

Syslog

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.

SSMTP and Mailhog

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

Timezone

The default timezone is set with TIMEZONE=UTC. Change it with an environment variable.

XDebug

The XDebug extension is installed but disabled by default. To enable, set the enviroment variable USE_XDEBUG=true.

Tweaks

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.

TODO

README.md

  • Usage instructions.
  • List of supported extensions.
  • ENV variables to enable extensions on demand.

Dockerfile

  • Remove nginx from image.

PHP

./update.sh