versions.json

{
  "_comment": "Release-completeness manifest. `platforms_required` are the SDK tarballs ephpm actually consumes (its release matrix hard-depends on them); a v<php_version> release missing any of these is broken. `platforms_optional` (musl) have no known consumers today -- we keep building them but never gate a release on them. `platforms_nts` are non-thread-safe variants built for consumers that cannot use ZTS; they are dispatched separately, never gate a release, and MUST NOT be moved into platforms_required. `minors_nts` selects which minors watch-php.yml keeps NTS tarballs current for. build.yml's verify-completeness step and watch-php.yml both read this file.",
  "minors": ["8.3", "8.4", "8.5"],
  "platforms_required": [
    "linux-x86_64-gnu",
    "linux-aarch64-gnu",
    "macos-aarch64",
    "windows-x86_64"
  ],
  "platforms_optional": [
    "linux-x86_64",
    "linux-aarch64"
  ],
  "platforms_nts": [
    "linux-x86_64-gnu-nts",
    "linux-aarch64-gnu-nts",
    "linux-x86_64-gnu-nts-shared",
    "linux-aarch64-gnu-nts-shared"
  ],
  "_comment_experimental": "platforms_experimental are dispatched explicitly (never as part of `all`, never gating a release) and MUST NOT move into platforms_required. windows-x86_64-clang is the clang-cl/TAILCALL-VM Windows build: 1.7x faster VM dispatch than the MSVC lane with the pinned LLVM (22.1.8), but the VS-bundled clang 19 is SLOWER than MSVC - see build.yml build-windows-clang comments before touching the pin. watch-php.yml keeps these current for the minors listed in minors_experimental (a separate reconciliation pass, mirroring minors_nts). minors_experimental MUST list only TAILCALL-capable minors (8.5+): 8.3/8.4 have no TAILCALL VM, so a clang build there is pointless and the VM-kind gate in build.yml would refuse to publish it.",
  "platforms_experimental": [
    "windows-x86_64-clang"
  ],
  "minors_nts": ["8.4"],
  "minors_experimental": ["8.5"]
}