E-Appointment PHP base images (zmsbase)

Infrastructure foundation: the zmsbase directory in this monorepo provides standardized, pre-built PHP runtime images for eappointment module builds via the Containerfile.

• Source: zmsbase/ in it-at-m/eappointment
• Historical standalone repo: it-at-m/eappointment-php-base (superseded by zmsbase)
• Original Berlin repository: gitlab.com/eappointment/php-base

Image variants and usage

Based on .github/workflows/zmsbase-build-images.yaml, the project publishes four groups of images:

• 8.4-base and 8.4-dev from zmsbase/php84/Dockerfile
• 8.3-base and 8.3-dev from zmsbase/php83/Dockerfile
• 8.3-local-amd64 and 8.3-local-arm64 from zmsbase/php83-local/Dockerfile
• 8.4-local-amd64 and 8.4-local-arm64 from zmsbase/php84-local/Dockerfile

The role split is:

• Local images (8.3-local-*, 8.4-local-*) are intended for local development and zmsautomation. Devcontainer/DDEV default to 8.3-local-* via ZMS_PHP_BASE_TAG.
• Non-local images (8.3-*, 8.4-* without -local) are intended for production/runtime-aligned environments.

This dual-architecture local setup supports development on macOS Apple Silicon and other non-amd64 environments while still providing linux/amd64 compatibility.

Local architecture support

The php_v8_3_local and php_v8_4_local jobs build single-architecture tags in a matrix:

• linux/amd64 on ubuntu-latest -> 8.3-local-amd64 / 8.4-local-amd64
• linux/arm64 on ubuntu-24.04-arm -> 8.3-local-arm64 / 8.4-local-arm64

Devcontainer and DDEV set ZMS_PHP_BASE_TAG via .devcontainer/scripts/sync-php-base-tag.sh.

Build and publish workflow behavior

Workflow: 🐳 Build ZMS base images (zmsbase-build-images.yaml).

It runs on:

• weekly schedule on main (Mondays 0 3 * * 1 UTC ≈ 05:00 Europe/Berlin in summer; GitHub runs scheduled workflows on the default branch only)
• manual workflow_dispatch on any branch (use after changing zmsbase/ on a feature branch before CI needs new images)

Each image job logs in to GHCR, builds image targets, validates PHP startup (php-fpm -t or php -v), and pushes resulting tags to:

• ghcr.io/it-at-m/eappointment/zmsbase

Module dependency context

%%{init: {"flowchart": {"defaultRenderer":"elk"}}}%%
graph TD
    subgraph InfrastructureFoundation["Infrastructure Foundation"]
        PHPBASE["zmsbase<br>PHP Docker Base Images<br>Runtime Environment"]
    end

    zmsapi --> zmsslim
    zmsapi --> zmsclient
    zmsapi --> zmsdldb
    zmsapi --> zmsdb
    zmsapi --> zmsentities

    zmsadmin --> mellon
    zmsadmin --> zmsclient
    zmsadmin --> zmsslim
    zmsadmin --> zmsentities

    zmscalldisplay --> mellon
    zmscalldisplay --> zmsclient
    zmscalldisplay --> zmsentities
    zmscalldisplay --> zmsslim

    zmsstatistic --> mellon
    zmsstatistic --> zmsentities
    zmsstatistic --> zmsslim
    zmsstatistic --> zmsclient

    zmsmessaging --> mellon
    zmsmessaging --> zmsclient
    zmsmessaging --> zmsentities
    zmsmessaging --> zmsslim

    zmsdb --> zmsentities
    zmsdb --> zmsdldb
    zmsdb --> mellon

    zmsclient --> zmsentities
    zmsclient --> zmsslim
    zmsclient --> mellon

    zmsentities --> mellon
    zmsslim --> mellon

    zmscitizenapi --> mellon
    zmscitizenapi --> zmsslim
    zmscitizenapi --> zmsclient
    zmscitizenapi --> zmsentities

    zmscitizenapi -.-> zmsapi
    refarch_gateway -.-> zmscitizenapi
    zmscitizenview -.-> refarch_gateway

    PHPBASE -->|provides runtime for| zmsapi
    PHPBASE -->|provides runtime for| zmsadmin
    PHPBASE -->|provides runtime for| zmscalldisplay
    PHPBASE -->|provides runtime for| zmsstatistic
    PHPBASE -->|provides runtime for| zmsmessaging
    PHPBASE -->|provides runtime for| zmsdb
    PHPBASE -->|provides runtime for| zmsclient
    PHPBASE -->|provides runtime for| zmsentities
    PHPBASE -->|provides runtime for| zmsslim
    PHPBASE -->|provides runtime for| zmsdldb
    PHPBASE -->|provides runtime for| mellon
    PHPBASE -->|provides runtime for| zmscitizenapi

    subgraph refarch["refarch"]
        style refarch stroke-dasharray:5
        refarch_gateway
        zmscitizenview
    end

    subgraph zms_modules["ZMS PHP Modules"]
        style zms_modules stroke-dasharray:5 5 1 5
        zmsapi
        zmsadmin
        zmscalldisplay
        zmsstatistic
        zmsmessaging
        zmsdb
        zmsclient
        zmsentities
        zmsslim
        zmsdldb
        mellon
        zmscitizenapi
    end

    classDef foundation fill:#e3f2fd,stroke:#0277bd,stroke-width:3px
    classDef citizenapi fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    classDef gateway fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
    classDef citizenview fill:#e8f5e8,stroke:#1b5e20,stroke-width:2px

    class PHPBASE foundation
    class zmscitizenapi citizenapi
    class refarch_gateway gateway
    class zmscitizenview citizenview