Examples: Migrate 003 + init-miniwebapp phpc.json to PSR-4 autoload (post-#1803)

[PurHur]

Problem

003-MiniWebApp and templates/init-miniwebapp/phpc.json hand-maintain includes[]:

"includes": ["src/Router.php", "config.php"]

This works today (#752 ✅ link) but breaks down for larger apps and self-host bundles (#1492) where class graphs grow. #1803 adds static PSR-4 class discovery for phpc build --project; #1762 tracks dynamic require $path.

Goal

After #1803 lands on master:

1. Replace includes[] with:

"autoload": { "psr-4": { "App\\": "src/" } }

2. Namespace Router as App\Router (or keep global class with empty prefix — pick one, document in docs/phpc-json.md)
3. Update public/index.php require / use lines
4. Keep script/check-init-miniwebapp-parity.sh green (DevEx: Keep phpc init --profile miniwebapp template in sync with examples/003-MiniWebApp #695)
5. Regenerate capability matrix if web rows change

Scope

• examples/003-MiniWebApp/phpc.json + src/Router.php namespace
• templates/init-miniwebapp/ mirror
• test/unit/PhpcInitMiniWebAppTest.php / parity script
• examples/README.md phpc.json section (one paragraph)
• VM + AOT smokes: make web-smoke, MiniWebAppAotExecuteTest, make examples-aot-smoke

Acceptance criteria

./phpc lint --all examples/003-MiniWebApp
./phpc build --project examples/003-MiniWebApp
./script/ci-local.sh --filter MiniWebAppAotExecuteTest
./script/check-init-miniwebapp-parity.sh
make examples-aot-smoke   # 003 slice when LLVM ready

Docker:

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  ./script/ci-local.sh --filter MiniWebAppAotExecuteTest

Dependencies

• DevEx: phpc.json autoload phase 2 — static class discovery for AOT project build #1803 — static PSR-4 discovery in lib/AOT/ProjectGraph.php (or AutoloadDiscovery.php)
• AOT: Dynamic require/include discovery for project build (phase 2 of #154) #1762 — dynamic requires (orthogonal)
• DevEx: PSR-4 autoload paths in phpc.json project manifest #155 — VM PSR-4 serve autoload (already ✅ for serve)

Out of scope

• Composer vendor autoload
• JIT project graph (JIT: Project include lowering for 003-MiniWebApp (phpc serve --jit blocked on #475) #1770, Testing: JIT smoke for phpc build --project on 003-MiniWebApp #587)

Links

• 🌐 North Star 1: Web-capable PHP application (living tracker) #1044 North Star 1 · DevEx: phpc init --profile miniwebapp (Router + templates scaffold) #632 init profile · ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 Phase 3 Web AOT

[PurHur]

Implementation hints expansion (batch 93)

Why PSR-4 for 003 matters

Flat includes[] in phpc.json works for VM (#539 ✅) but blocks:

• DevEx: phpc.json autoload phase 2 — static class discovery for AOT project build #1803 static class discovery for AOT project build
• Testing: JIT smoke for phpc build --project on 003-MiniWebApp #587 / JIT: Project include lowering for 003-MiniWebApp (phpc serve --jit blocked on #475) #1770 JIT project graph (Router in src/)
• AOT: Dynamic require/include discovery for project build (phase 2 of #154) #1762 dynamic require phase 2

Migration steps (003 first, init template second)

Step	Path	Command
1	examples/003-MiniWebApp/phpc.json	Add PSR-4 "autoload": { "App\\": "src/" } per #1803 schema
2	examples/003-MiniWebApp/public/index.php	use App\Router; instead of manual require
3	templates/init-miniwebapp/	Sync via check-init-miniwebapp-parity.sh (#695)
4	Lint	phpc lint --all examples/003-MiniWebApp
5	Smoke	make miniwebapp-gates / make examples-web-smoke

Acceptance commands

./phpc lint --all examples/003-MiniWebApp
make examples-web-smoke
MINIWEBAPP_JIT_PROJECT_GATE=1 ./script/ci-local.sh --filter MiniWebApp   # after #587
docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev make web-smoke

Dependencies (do not parallelize blindly)

1. DevEx: phpc.json autoload phase 2 — static class discovery for AOT project build #1803 — autoload schema + discovery in ProjectManifest.php
2. This issue — migrate canonical 003 + init template
3. Testing: JIT smoke for phpc build --project on 003-MiniWebApp #587 → Testing: promote MiniWebAppJitProjectTest to ci-fast when #587 green #730 / CI: Default MINIWEBAPP_JIT_PROJECT_GATE=1 in ci-local after #587 green #1869 — JIT project gates
4. AOT: Dynamic require/include discovery for project build (phase 2 of #154) #1762 — dynamic require for non-literal paths

ROADMAP #78 Phase 3 carryover.

[PurHur]

Closing as not on the self-host (M2–M5) critical path tracked by #1492, and this run is constrained to self-host compiler work only (no example/presenter migrations). If this is still desired for examples/DevEx, please reopen under a non-selfhost milestone/queue.