Issues

Process: master must be green — branch protection requiring the Compiler gate once #36377 lands, a CI-streak metric in release-readiness, and a rule that a red master blocks all non-fix merges (.github/workflows/compiler-gate.yml, script/release-readiness.sh, CONTRIBUTING.md)

PurHur/php-compiler#36401 · opened

on Sep 2, 2026

236

Reliability: reproducible builds and signed releases — byte-identical binaries across machines for the same inputs, pinned TargetMachine, sorted symbol emission, SOURCE_DATE_EPOCH, checksums and signatures on release artifacts (lib/JIT/Context.php emitToFile, lib/AOT/Linker.php, .github/workflows/release.yml)

PurHur/php-compiler#36399 · opened

on Sep 2, 2026

14

Reliability: differential fuzzing — a grammar-based PHP program generator (types × operators × control flow × builtins) run nightly against Zend vs VM vs AOT with automatic reduction and dedup by crash signature (script/fuzz/, test/differential/cases/fuzz/)

PurHur/php-compiler#36398 · opened

on Sep 2, 2026

10

DX: every "unsupported" error names the feature, links its matrix row and issue, and suggests the supported alternative; `phpc lint --project` published as `purhur/phpc-lint` for users' CI (lib/Lint/, lib/UnsupportedRegistry.php, composer package)

PurHur/php-compiler#36396 · opened

on Sep 2, 2026

15

DECISION + epic: what the self-host north star buys the user — a static `phpc` binary as the distribution artifact (no host PHP, no composer, no patches), with a scoped M5 that stops at "compiles user projects natively" (docs/self-host-target.md, prelinked/bootstrap-gen0/)

PurHur/php-compiler#36393 · opened

on Sep 2, 2026

4

Product: the web deployment story end to end — `phpc fcgi` worker + nginx recipe + `phpc deploy --oci` producing a from-scratch container, a living demo of 003-MiniWebApp on purh.pw with uptime monitoring, and req/s + memory vs php-fpm in the docs (bin/fcgi.php, docs/deploy-production.md, examples/003-MiniWebApp)

PurHur/php-compiler#36392 · opened

on Sep 2, 2026

2

Distribution: platform matrix — linux/arm64 first (per-arch helper cache, CI on an arm64 runner or QEMU), then macOS arm64; a target-triple abstraction in Linker/TargetMachine instead of x86_64 assumptions (prelinked/helper-runtime/<arch>/, lib/AOT/Linker.php, lib/JIT/Context.php)

PurHur/php-compiler#36391 · opened

on Sep 2, 2026

90

Distribution: one-command install — `ghcr.io/purhur/phpc` image (LLVM 9 + prelinked runtime + helper cache) and a tarball SDK, with a "fresh machine to hello binary in < 5 min" gate (Docker/release/, script/cold-build-check.sh, docs/GETTING-STARTED.md)

PurHur/php-compiler#36390 · opened

on Sep 2, 2026

4

Release: ship v1.1.0 now with an honest "known limitations" section, then a fixed cadence — release-readiness must complete in < 15 min, changelog generated from closed issues, every README number generated (CHANGELOG.md, script/release-readiness.sh, .github/workflows/release.yml)

PurHur/php-compiler#36389 · opened

on Sep 2, 2026

11

Performance: v2.0 targets and the codegen roadmap to reach them — typed code ≥ 3x Zend, untyped ≤ 1.5x slower, web request ≥ php-fpm: inline caches for property/method access, escape analysis for arrays/strings, guarded speculation, per-function O1 by default (lib/JIT.php, lib/JIT/Builtin/Type/Object_.php, lib/JIT/Analyzer.php)

PurHur/php-compiler#36386 · opened

on Sep 2, 2026

651

Performance: benchmark suite v2 — the benchmark-game set plus web-request and real-app workloads, per-commit history in JSON, a public chart page, and `bench-gate` extended to all of it (benchmarks/, script/bench-gate.php, docs/pages/bench.html)

PurHur/php-compiler#36385 · opened

on Sep 2, 2026

48

Language: probe the syntax/feature matrix per backend instead of copying the JIT column, add PHP 8.3/8.4 feature rows, and decide the supported PHP baseline (docs/capabilities-syntax.md, script/capability-syntax*.php) — DECISION for the maintainer inside

PurHur/php-compiler#36384 · opened

on Sep 2, 2026

2

Compatibility: real-world application corpus — build and run 12 open-source PHP packages with their own test suites under VM and AOT, publish a scoreboard, one issue per failure (test/apps/, docs/pages/apps.html)

PurHur/php-compiler#36380 · opened

on Sep 2, 2026

44

Wave 2 (Sep 2026): from a working compiler to a compiler people use — install, real projects, speed, trust — automation tracker

PurHur/php-compiler#36379 · opened

on Sep 2, 2026

17

Foundation: LLVM 9 → 22 migration Phase 0 — prove the FFI binding can be generated against LLVM 22 headers and thread pointee types on LLVM 9 (docs/roadmap/LLVM22-MIGRATION.md)

PurHur/php-compiler#36220 · opened

on Sep 1, 2026

Tests: one-file-per-issue sprawl — 6,439 test/repro files and 3,951 test/unit/*AotTest.php with 1,270 explicit phpunit.xml entries; promote to the differential corpus and directory suites (test/repro, test/unit, phpunit.xml.dist)

PurHur/php-compiler#36219 · opened

on Sep 1, 2026

CI: no compliance signal exists — compliance-pr.yml has been dispatch-only since 2026-07-30 and the nightly dies in setup; run the suite per PR on the touched areas plus a random stratum (.github/workflows/compliance-pr.yml, script/shard-compliance.sh)

PurHur/php-compiler#36212 · opened

on Sep 1, 2026

Architecture: per-extension manifest (ext/<name>/ext.json) with declared deps and default-enabled flag; remove lib→ext imports; fold 54 policy classes + 30 enable flags into it (lib/ExtensionRegistry.php, lib/ModuleAbstract.php) (re-#23480)

PurHur/php-compiler#36204 · opened

on Sep 1, 2026

93

Navigation Menu

Repository navigation

Issues

Process: master must be green — branch protection requiring the Compiler gate once #36377 lands, a CI-streak metric in release-readiness, and a rule that a red master blocks all non-fix merges (.github/workflows/compiler-gate.yml, script/release-readiness.sh, CONTRIBUTING.md)

Reliability: differential fuzzing — a grammar-based PHP program generator (types × operators × control flow × builtins) run nightly against Zend vs VM vs AOT with automatic reduction and dedup by crash signature (script/fuzz/, test/differential/cases/fuzz/)

DX: every "unsupported" error names the feature, links its matrix row and issue, and suggests the supported alternative; `phpc lint --project` published as `purhur/phpc-lint` for users' CI (lib/Lint/, lib/UnsupportedRegistry.php, composer package)

DECISION + epic: what the self-host north star buys the user — a static `phpc` binary as the distribution artifact (no host PHP, no composer, no patches), with a scoped M5 that stops at "compiles user projects natively" (docs/self-host-target.md, prelinked/bootstrap-gen0/)

Distribution: platform matrix — linux/arm64 first (per-arch helper cache, CI on an arm64 runner or QEMU), then macOS arm64; a target-triple abstraction in Linker/TargetMachine instead of x86_64 assumptions (prelinked/helper-runtime/<arch>/, lib/AOT/Linker.php, lib/JIT/Context.php)

Distribution: one-command install — `ghcr.io/purhur/phpc` image (LLVM 9 + prelinked runtime + helper cache) and a tarball SDK, with a "fresh machine to hello binary in < 5 min" gate (Docker/release/, script/cold-build-check.sh, docs/GETTING-STARTED.md)

Release: ship v1.1.0 now with an honest "known limitations" section, then a fixed cadence — release-readiness must complete in < 15 min, changelog generated from closed issues, every README number generated (CHANGELOG.md, script/release-readiness.sh, .github/workflows/release.yml)

Performance: benchmark suite v2 — the benchmark-game set plus web-request and real-app workloads, per-commit history in JSON, a public chart page, and `bench-gate` extended to all of it (benchmarks/, script/bench-gate.php, docs/pages/bench.html)

Language: probe the syntax/feature matrix per backend instead of copying the JIT column, add PHP 8.3/8.4 feature rows, and decide the supported PHP baseline (docs/capabilities-syntax.md, script/capability-syntax*.php) — DECISION for the maintainer inside

Compatibility: real-world application corpus — build and run 12 open-source PHP packages with their own test suites under VM and AOT, publish a scoreboard, one issue per failure (test/apps/, docs/pages/apps.html)

Wave 2 (Sep 2026): from a working compiler to a compiler people use — install, real projects, speed, trust — automation tracker

Foundation: LLVM 9 → 22 migration Phase 0 — prove the FFI binding can be generated against LLVM 22 headers and thread pointee types on LLVM 9 (docs/roadmap/LLVM22-MIGRATION.md)

Tests: one-file-per-issue sprawl — 6,439 test/repro files and 3,951 test/unit/*AotTest.php with 1,270 explicit phpunit.xml entries; promote to the differential corpus and directory suites (test/repro, test/unit, phpunit.xml.dist)

CI: no compliance signal exists — compliance-pr.yml has been dispatch-only since 2026-07-30 and the nightly dies in setup; run the suite per PR on the touched areas plus a random stratum (.github/workflows/compliance-pr.yml, script/shard-compliance.sh)

Architecture: per-extension manifest (ext/<name>/ext.json) with declared deps and default-enabled flag; remove lib→ext imports; fold 54 policy classes + 30 enable flags into it (lib/ExtensionRegistry.php, lib/ModuleAbstract.php) (re-#23480)