yohannaftali/php7-fpm repository overview

⁠yohannaftali/php7-fpm

PHP 7.4-FPM⁠ image with common extensions, sendmail and Xdebug, with the container clock set to Asia/Jakarta (WIB, UTC+7); PHP itself stays on UTC (see Overview).

• Docker Hub: https://hub.docker.com/r/yohannaftali/php7-fpm⁠
• Source code (Dockerfile, build workflow, scripts): https://github.com/yohannaftali/dockerhub-yohannaftali-php7-fpm⁠
• Issues and feature requests: https://github.com/yohannaftali/dockerhub-yohannaftali-php7-fpm/issues⁠

⁠Use this image

No build needed. Pull the prebuilt image straight from Docker Hub:

docker pull yohannaftali/php7-fpm

Or reference it in your docker-compose.yml:

services:
  php:
    image: yohannaftali/php7-fpm:latest

⁠Overview

Built FROM php:7-fpm (PHP 7.4.33, Debian 11) and adds:

• Timezone: TZ=Asia/Jakarta for the operating system (date, logs, cron). PHP's date.timezone is intentionally left at its default, UTC, so applications stay timezone-agnostic. Set date_default_timezone_set() or date.timezone yourself if you need local time.
• Extensions: gd (freetype, jpeg, webp libs), mysqli, pdo, pdo_mysql, pgsql, pdo_pgsql, xmlrpc, zip, opcache, soap, bcmath, mbstring, pcntl, intl, apcu, xdebug (3.1.6, the last release supporting PHP 7.4).
• Mail: sendmail configured as sendmail_path. The entrypoint restarts it on container start.
• Hosts entry: the entrypoint appends the container's IP and hostname to /etc/hosts (needed by sendmail).
• Tools: nano, wget, curl, zip, unzip, and jpegoptim, optipng, pngquant, gifsicle.

Xdebug is installed but not started automatically (xdebug.remote_autostart=off). Note that xdebug.remote_* are Xdebug 2 setting names and are ignored by Xdebug 3, so configure it with xdebug.mode and xdebug.client_host through your own ini file.

⁠Tags

⁠Quick start

services:
  php:
    image: yohannaftali/php7-fpm:latest
    restart: unless-stopped
    volumes:
      - ./app:/var/www/html
    expose:
      - "9000"

  web:
    image: nginx:stable
    ports:
      - "8080:80"
    volumes:
      - ./app:/var/www/html:ro
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      - php

Verify the image:

docker run --rm yohannaftali/php7-fpm php -v
docker run --rm yohannaftali/php7-fpm date +%Z      # WIB
docker run --rm yohannaftali/php7-fpm php -r 'echo date_default_timezone_get();'   # UTC (by design)
docker run --rm yohannaftali/php7-fpm php -m

⁠Build (maintainers)

docker login

# latest
docker build -t yohannaftali/php7-fpm:latest .

# specific base tag
docker build --build-arg PHP_VERSION=7.4-fpm -t yohannaftali/php7-fpm:7.4 .

docker push yohannaftali/php7-fpm --all-tags

Multi-arch (amd64 + arm64):

docker buildx build --platform linux/amd64,linux/arm64 \
  --build-arg PHP_VERSION=7.4-fpm \
  -t yohannaftali/php7-fpm:7.4 --push .

⁠Automated publishing

.github/workflows/docker-publish.yml builds and pushes the images on every push to main, weekly, and on manual dispatch. It also syncs this README to the Docker Hub overview and the short description.

Required GitHub repository secrets:

To change which tags are published, edit the include matrix in the workflow and the Tags table above.

⁠Maintaining the Docker Hub repository

• Overview: synced from this README.md by the workflow.
• Short description: set in the workflow (short-description), max 100 characters.
• Manual sync / status: see Maintenance scripts⁠.
• Category: not exposed through the API; set manually in Repository → Settings → Categories.
• Tags: remove stale tags in Repository → Tags.

⁠Maintenance scripts

Helper scripts in scripts/ manage the Docker Hub repository from your machine. They need uv⁠ and a .env file (copy .env.example) with DOCKERHUB_USERNAME and DOCKERHUB_TOKEN. There are no other dependencies.

Bash:

./scripts/dockerhub-update.sh            # sync
./scripts/dockerhub-update.sh status
./scripts/dockerhub-update.sh tags
./scripts/dockerhub-update.sh delete-tag 7.4

PowerShell:

.\scripts\dockerhub-update.ps1            # sync
.\scripts\dockerhub-update.ps1 status
.\scripts\dockerhub-update.ps1 tags
.\scripts\dockerhub-update.ps1 delete-tag 7.4

Both wrappers call scripts/dockerhub_update.py through uv run. Set DOCKERHUB_REPO to target a repository other than php7-fpm.

⁠Source and contributing

The Dockerfile, GitHub Actions workflow and maintenance scripts live at https://github.com/yohannaftali/dockerhub-yohannaftali-php7-fpm⁠. Open an issue there to report a problem.

⁠License

The Dockerfile in this repository is provided as-is. PHP is licensed under the PHP License; see the official image⁠ for details.