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 these images:
8.4-baseand8.4-devfromzmsbase/php84/Dockerfile8.4-local-amd64and8.4-local-arm64fromzmsbase/php84-local/Dockerfile8.6-baseand8.6-devfromzmsbase/php86/Dockerfile(PHP 8.6.0, released 19 November 2026)8.6-local-amd64and8.6-local-arm64fromzmsbase/php86-local/Dockerfile
The role split is:
- Local images (
8.4-local-*) are intended for local development andzmsautomation. Devcontainer defaults to8.4-local-*viaZMS_PHP_BASE_TAG.8.6-local-*is available for trying PHP 8.6. - Non-local images (
8.4-base,8.4-dev) are intended for production/runtime-aligned environments. Module images and CI use8.4-baseand8.4-dev.8.6-baseand8.6-devare built alongside them and are not wired into module images yet.
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_4_local and php_v8_6_local jobs build single-architecture tags in a matrix:
linux/amd64onubuntu-latest->8.4-local-amd64and8.6-local-amd64linux/arm64onubuntu-24.04-arm->8.4-local-arm64and8.6-local-arm64
Devcontainer sets ZMS_PHP_BASE_TAG and pulls that image via .devcontainer/scripts/sync-php-base-tag.sh before Compose starts.
Build and publish workflow behavior
Workflow: 🐳 Build ZMS base images (zmsbase-build-images.yaml).
It runs on:
- weekly schedule on
main(Mondays0 3 * * 1UTC ≈ 05:00 Europe/Berlin in summer; GitHub runs scheduled workflows on the default branch only) - manual
workflow_dispatchon any branch (use after changingzmsbase/on a feature branch before CI needs new images). Thephp_versioninput buildsall,8.4, or8.6; the weekly schedule always builds every line.
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
That GHCR publish is the public half of the CI/CD flow (Quay mirror, GitLab Helm, OpenShift).
Module dependency context
%%{init: {"flowchart": {"defaultRenderer":"elk"}}}%%
graph TD
subgraph InfrastructureFoundation["Infrastructure Foundation"]
PHPBASE["zmsbase<br>PHP Docker Base Images<br>Runtime Environment"]
end
zmsbackend --> zmsslim
zmsbackend --> zmsclient
zmsbackend --> zmsdldb
zmsbackend --> 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
zmsclient --> zmsentities
zmsclient --> zmsslim
zmsclient --> mellon
zmsentities --> mellon
zmsslim --> mellon
zmscitizenapi --> mellon
zmscitizenapi --> zmsslim
zmscitizenapi --> zmsclient
zmscitizenapi --> zmsentities
zmscitizenapi -.-> zmsbackend
refarch_gateway -.-> zmscitizenapi
zmscitizenview -.-> refarch_gateway
PHPBASE -->|provides runtime for| zmsbackend
PHPBASE -->|provides runtime for| zmsadmin
PHPBASE -->|provides runtime for| zmscalldisplay
PHPBASE -->|provides runtime for| zmsstatistic
PHPBASE -->|provides runtime for| zmsmessaging
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
zmsbackend
zmsadmin
zmscalldisplay
zmsstatistic
zmsmessaging
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