virtuasa/php-dev repository overview

⁠Docker Image - PHP DEV

The images are built and published on Docker Hub⁠.

All images are also available on Smile Registry⁠ You can replace "virtuasa/" by "registry.smile.fr/smile-suisse/" to use Smile registry

• Base Images

  • virtuasa/php-dev:bookworm-sury⁠ debian image with tools

• PHP Images virtuasa/php-dev:${PHP_VERSION}-${TYPE}-bookworm-sury PHP_VERSION=(5.6 7.0 7.1 7.2 7.3 7.4 8.0 8.1 8.2 8.3 8.4)

  • CLI for php CLI propose
    • Template : virtuasa/php-dev:${PHP_VERSION}-cli-bookworm-sury
    • Example : virtuasa/php-dev:8.3-cli-bookworm-sury⁠
  • FPM for php CLI and FPM service
    • Template : virtuasa/php-dev:${PHP_VERSION}-fpm-bookworm-sury
    • Example : virtuasa/php-dev:8.3-fpm-bookworm-sury⁠
  • NGINX for php CLI and NGINX website
    • Template : virtuasa/php-dev:${PHP_VERSION}-nginx-bookworm-sury
    • Example : virtuasa/php-dev:8.3-nginx-bookworm-sury⁠
  • Apache for php CLI and APACHE website
    • Template : virtuasa/php-dev:${PHP_VERSION}-apache-bookworm-sury
    • Example : virtuasa/php-dev:8.3-apache-bookworm-sury⁠

• PHP with NodeJS virtuasa/php-dev:${PHP_VERSION}-${TYPE}-node-${NODE_VERSION}-bookworm-sury NODE_VERSION=(18 20 22)

  • CLI for php CLI propose with NodeJS tools
    • Template : virtuasa/php-dev:${PHP_VERSION}-cli-node-${NODE_VERSION}-bookworm-sury
    • Example : virtuasa/php-dev:8.3-cli-node-22-bookworm-sury⁠
  • FPM for php CLI and FPM service with NodeJS tools
    • Template : virtuasa/php-dev:${PHP_VERSION}-fpm-node-${NODE_VERSION}-bookworm-sury
    • Example : virtuasa/php-dev:8.3-fpm-node-22-bookworm-sury⁠
  • NGINX for php CLI and NGINX website with NodeJS tools
    • Template : virtuasa/php-dev:${PHP_VERSION}-nginx-node-${NODE_VERSION}-bookworm-sury
    • Example : virtuasa/php-dev:8.3-nginx-node-22-bookworm-sury⁠
  • Apache for php CLI and APACHE website with NodeJS tools
    • Template : virtuasa/php-dev:${PHP_VERSION}-apache-node-${NODE_VERSION}-bookworm-sury
    • Example : virtuasa/php-dev:8.3-apache-node-22-bookworm-sury⁠

⁠Build

Use make help to see the build targets.

Examples:

• make all build all images
• make all-php build all php images
• make base php-8.3 php-8.3-node-18 build php 8.1 images

⁠Images content

To customize this 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

⁠Base image variables

⁠PHP image variables

⁠PHP apache variables

⁠PHP nginx 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 /data of the mount path if needed.

*** FIXUID and FIXGID must be set globally 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 :

⁠PHP images

⁠Readonly environment variables

⁠Example of docker compose.yml

version: '3.9'

services:
  web:
    image: virtuasa/php-dev:8.3-nginx-node-22-bookworm-sury
    user: ${FIXUID:-1000}:${FIXGID:-1000}
    volumes:
      - .:/data
    links:
      - db
      - redis
    environment:
      - HISTFILE=/data/var/.docker_bash_history
      - HISTFILESIZE=1000
      - DOCUMENT_ROOT=public
      - SSL_CERT_PEM=/data/setup/ssl/app.crt
      - SSL_CERT_KEY=/data/setup/ssl/app.key
      - SSL_FORCE=yes
      - SERVER_NAMES=app.amce.docker
      - XDEBUG_MAIN_HOST=app.amce.docker
      - XDEBUG_CLIENT_HOST=host.docker.internal
    extra_hosts:
      - 'host.docker.internal:host-gateway'
    labels:
      - "com.dnsdock.alias=app.amce.docker"