Technical documentation for php-compiler contributors and operators. End-user narrative and progress visuals live on GitHub Pages (docs/pages/ only — not mirrored from this folder).
Public pages do not link to generated matrices or inventory maps listed under Contributor-only below.
| Page | URL |
|---|---|
| Overview | purhur.github.io/php-compiler/docs/pages/index.html |
| Development status (short) | purhur.github.io/php-compiler/development-status.html |
| Missing implementation (gap tables) | purhur.github.io/php-compiler/docs/pages/missing-implementation.html |
| PHP capability comparison | purhur.github.io/php-compiler/docs/pages/capability-comparison.html |
| Repository | github.com/PurHur/php-compiler |
Edit sources: pages/index.html · pages/development-status.md · pages/missing-implementation.html · pages/capability-comparison.html (generated) · pages/PAGES.md.
| Doc | Use when |
|---|---|
| GETTING-STARTED.md | First clone, demo script, phpc cheat sheet |
| ../README.md | Install, CI, north stars, examples table |
| pages/development-status.md | Short public status (sync to site) |
| pages/missing-implementation.html | Gap tables for self-host / M3 emit |
Generated maps and large tables — repo only; exclude from docs/pages/ content and links:
| Doc | Content |
|---|---|
| capabilities.md | Builtin matrix (php script/capability-matrix.php) |
| capabilities-syntax.md | Language construct matrix |
| bootstrap-inventory.md | lib/ file inventory |
| bootstrap-vendor-inventory.md | Vendor prelink inventory |
| local-ci-matrix.md | Host / Docker CI matrix |
| miniwebapp-aot-unskip-matrix.md | AOT execute bisect matrix |
| roadmap-wave3.md | Wave 3 PR table (#1354–#1379); drift guard: php script/check-wave3-roadmap-sync.php (default in ./script/ci-fast.sh via WAVE3_ROADMAP_SYNC_GATE=1; opt-out =0, issues #1802, #1814) |
| M2 spine issue hygiene | php script/check-m2-spine-issue-hygiene.php (default in ci-fast.sh via M2_SPINE_ISSUE_HYGIENE_GATE=1; opt-out =0 for bulk spine PRs, issue #1819) |
| Doc | Content |
|---|---|
| unsupported-syntax.md | Lint / unsupported registry |
| stdlib-jit-audit.md | Stdlib JIT coverage audit |
| runtime-semantics.md | Runtime behaviour notes |
| Doc | Content |
|---|---|
| deploy-web-aot.md | Quickstart: phpc build → phpc deploy → CGI |
| deploy-production.md | Production guide: nginx, TLS, security, operations (#445) |
| phpc-json.md | Project manifest |
| miniwebapp-gates.md | Gate ladder for 003-MiniWebApp |
| miniwebapp-aot-unskip-matrix.md | AOT execute bisect matrix |
| Doc | Content |
|---|---|
| bootstrap-dev-workflow.md | Tiered gen-1+ daily path, spine checklist, sidecar refresh, CI |
| bootstrap-sdk-platform.md | Bootstrap SDK platform contract — Linux x86_64, LLVM 9, RAM, Docker (#15606) |
| bootstrap-selfhost.md | Gates, waves, stub policy |
| bootstrap-generations.md | Gen-0…gen-3 ladder, artifacts, presenter commands |
| bootstrap-inventory.md | lib/ inventory (php script/bootstrap-inventory.php) |
| bootstrap-vendor-inventory.md | Vendor / parser strategy |
| bootstrap-m5-fast-path.md | M5 planning + fast feedback loops (~20ms probes) |
| Doc | Content |
|---|---|
| dev/types.md | Type system notes |
| dev/macros.md | Macro / codegen notes |
- Roadmap umbrella: #78
- North star (self-host): #1492 (was #1056)
- Example integration tests (003-MiniWebApp, …): regression only — closed #1044
- Wave 3 batch: #1380
- Release plan and criteria — phased plan, falsifiable release criteria (issue #23474).
- LLVM 9 → 22 migration — opaque-pointer transition, probed facts, de-risking order.
Contributor and agent entry point: AGENTS.md.