Skip to content

php.md

Latest commit

 

History

History
62 lines (48 loc) · 2.6 KB

php.md

File metadata and controls

62 lines (48 loc) · 2.6 KB
Raw

PHP images

build-php.yml and merge-php.yml publish the three stages of a Specs PHP image. They are thin shims over build.yml and merge.yml, holding only the PHP-specific part: which stages get published, and under what name.

jobs:

  build:
    uses: specsnl/github-actions/.github/workflows/build-php.yml@2.4.2
    strategy:
      fail-fast: false
      matrix:
        runner:
          - os: ubuntu-24.04
            platform: linux/amd64
          - os: ubuntu-24.04-arm
            platform: linux/arm64
    with:
      runs-on: ${{ matrix.runner.os }}
      platform: ${{ matrix.runner.platform }}
      image-name: ghcr.io/${{ github.repository }}

  merge:
    needs: build
    uses: specsnl/github-actions/.github/workflows/merge-php.yml@2.4.2
    with:
      runs-on: ubuntu-24.04
      image-name: ghcr.io/${{ github.repository }}

Each shim fans out into one build.yml / merge.yml call per stage, so a single call publishes all three.

A repository publishing several flavours of the same PHP version — fpm, apache, frankenphp — adds a second matrix dimension over dockerfile / image-name pairs, and matches it with a matrix over image-name on the merge job. specsnl/php84 is the reference.

What gets published

Dockerfile target Image name Also tagged as
runtime <image-name> —
builder <image-name>/builder —
builder_nodejs <image-name>/builder_nodejs <image-name>/node

The runtime stage is the image itself; the builder stages are separate, nested packages with their own :latest. That is the right shape here — a builder image is a different product from the runtime, not a variant of it. A CLI that ships several base images does the opposite and uses tag suffixes on one name.

builder_nodejs is merged under two names from the same manifest, so the shorter node alias stays available.

Titles and descriptions

build-php.yml takes one title / description pair for all three stages. merge-php.yml takes them per stage — title-runtime, title-builder, title-builder_nodejs and their description-* counterparts — because that is where the manifest is tagged and where the labels end up mattering per package.

AppArmor

disable-apparmor: true disables AppArmor on the runner before building, for images whose build steps it interferes with. It is forwarded to build.yml unchanged.