virtuasa/php repository overview

⁠Virtua Docker Image - PHP

These images are built and published on VirtuaSA Docker Hub⁠.

⁠Build

• Run the script ./docker-build.sh:
  • ./docker-build.sh <PHP_VERSION>
  • ./docker-build.sh all
• Images can be pushed from GitlabCI if all tests are OK

⁠Images content

To customize these setup on your projects, changes must only be done to file docker-compose.yml⁠.

Apache calls PHP with mod_php. Nginx calls PHP with php-fpm

⁠Usage

⁠Customizable environment variables

* Path is relative to the Docker container mount path, i.e., to the root of the project.

** Path is absolute in the Docker container, don't forget to add the path of the mount path if needed.

*** FIXUID and FIXGID must be set globaly host side.

⁠FIXUID and FIXGID

If you host linux user don't have the id 1000 (check with id), please set the globals variables to your session :

   printf "FIXUID=`id -u`\nFIXGID=`id -g`" >> ~/.profile

When using docker-compose file, set user parameter for the container like that :

    user: ${FIXUID:-1000}:${FIXGID:-1000}

⁠Special Extra Tools

List of extra command line tools, not exhaustive :

⁠Readonly environment variables

⁠Limitations with old PHP versions

• PHP 5.2:
  • Using DOCKER_COPY_CONFIG_TO_HOST=true will override host local files sharring the same names on each startup of the container.
  • Using DOCKER_WEB_SERVER=nginx is not allowed, and apache will be used instead, this can be overriden by setting the value of DOCKER_WEB_SERVER with a script loaded by DOCKER_CUSTOM_INIT.
• PHP 5.3:
  • Using DOCKER_WEB_SERVER=nginx is not allowed, and apache will be used instead, this can be overriden by setting the value of DOCKER_WEB_SERVER with a script loaded by DOCKER_CUSTOM_INIT.
• PHP < 5.5:
  • Using XHGUI_ACTIVE=true is incompatible, on Docker start the variable will be overriden to XHGUI_ACTIVE=false.