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
./binand 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();'
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).
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
To set the user that the PHP-FPM process runs as, you can set the php.ini directives "user" and "listen.owner" using the "php.ini directives" feature outlined in the section below. e.g:
docker run -e PHP_FPM_USER=1000 -e PHP_FPM_LISTEN__OWNER=1000 chekote/php:5.6.30-a php-fpm5.6
You can modify any php.ini directives by setting environmental variables within the container. This can be accomplished by prefixing the variable with the particular environment to be affected (FPM, CLI or ALL for both).
Note: If you want to set a directive th 6D2B at has a period in the name, you should substitude the period for a double underscore in your environmental variable name. e.g. to set the PHP FPM listen.owner directive, you would use an environmental variable named PHP_FPM_LISTEN__OWNER.
A few examples:
| 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
Docker Hub : https://hub.docker.com/r/chekote/php/