Skip to content

README.md

Latest commit

 

History

History
65 lines (37 loc) · 3.88 KB

README.md

File metadata and controls

65 lines (37 loc) · 3.88 KB
Raw

Docker image for PHP

A Docker image for the PHP Command Line scripting language.

To use the container with a project, do the following:

  • Copy the bin directory into your project.

  • Ensure that your profile PATH includes ./bin and that it takes priority over any other directory that may include a php executable:

    PATH=./bin:$PATH

Now whenever you are in your project's directory, you can simply execute php as you would with a typical composer installation, and the command will execute in the container instead:

php -r 'phpinfo();'

User ID control

It is possible to control what UID the initial process (usually PHP) and/or PHP-FPM processes run as. The bin/php file already does this for the initial process.

This is important if you are mounting a volumes into the container, as the the UID of the initial process or PHP-FPM will likely need to match the volume to be able to read and/or write to it.

Note: You should NOT try to set the UID using Dockers -u or --user option, as this does not ensure that the user actually exists (entry in /etc/passwd home directory etc).

Initial process UID

To set the UID for the initial process, you should set a LOCAL_USER_ID environmental variable on the container. e.g:

docker run -e LOCAL_USER_ID=1000 chekote/php:5.6.30-a php -v

www-data UID (PHP-FPM runs as this user)

To set the UID for the www-data user (and by extension, the PHP-FPM process), you should set the WWW_DATA_USER_ID environmental variable on the container. e.g:

docker run -e WWW_DATA_USER_ID=1000 chekote/php:5.6.30-a php-fpm5.6

php.ini directives

You can modify any php.ini directives by setting environmental variables within the container. It can be accomplish by prefixing the variable with the place to be replace ( FPM, CLI or ALL for both ). If the variable contains a dot . in it you can accomplish this by using a double underscore __ on the variable name. The following are some examples of how to accomplish this:

environmental variable php.ini directives php.ini config file
PHP_FPM_POST_MAX_SIZE post_max_size fpm
PHP_ALL_UPLOAD_MAX_FILESIZE upload_max_filesize fpm, cli
PHP_CLI_MAX_FILE_UPLOADS max_file_uploads cli
PHP_FPM_PM__MAX_CHILDREN pm.max_children fpm
PHP_ALL_SESSION__SAVE_PATH session.save_path fpm, cli
PHP_ALL_SESSION__SAVE_HANDLER session.save_handler fpm, cli

e.g. the following will start a PHP container with the post_max_size to 30 Megabytes for both CLI and FPM:

docker run -e PHP_ALL_UPLOAD_MAX_FILESIZE=30M chekote/php:7

and the following will start a PHP container with the pm.max_children setting to 50 for FPM processes:

docker run -e PHP_FPM_PM__MAX_CHILDREN=50 chekote/php:7

and the following will start a PHP container with the session.save_handler on both FPM and CLI using redis:

docker run -e PHP_ALL_SESSION__SAVE_HANDLER=redis chekote/php:7

Distribution

Docker Hub : https://hub.docker.com/r/chekote/php/