Testing: MiniWebApp AOT binary CLI execute smoke (tracked in #747, blocked #764)

[PurHur]

Problem

#478 covers phpc serve --aot HTTP routes. #454 tracks ExamplesCompileTest for the 003 tree. There is no PHPUnit gate that:

1. phpc build --project examples/003-MiniWebApp (link green — AOT: MiniWebApp phpc build --project native link fails on master (post-#568/#734) #752 ✅)
2. Runs .phpc/bin/app without TCP, with CGI env (QUERY_STRING, REQUEST_METHOD, REQUEST_BODY)

CLI execute catches AOT runtime bugs earlier than ServeAotTest and matches production CGI deployment (#50).

Active blocker: #764 — binary exits 0 with empty stdout for home/hello routes (not link failure).

Goal

test/unit/MiniWebAppAotExecuteTest.php (tracked in #747; implement here or split methods):

Step	Assert
Build	phpc build --project exit 0
GET home	QUERY_STRING=route=home stdout contains app_name from config.php
GET hello	QUERY_STRING=route=hello&name=Dev greeting
POST contact	REQUEST_METHOD=POST + REQUEST_BODY=name=PostDev thank-you (#257 pattern)
GET api	JSON ok (#61)
PATH_INFO	PATH_INFO=/hello + QUERY_STRING=name=Dev (#489)

Start with markTestSkipped('Blocked by #764 — AOT execute empty stdout') until runtime green.

Implementation hints

Piece	File	Notes
Test class	test/unit/MiniWebAppAotExecuteTest.php	@group llvm, @group miniwebapp
Helper	runBinaryWithCgiEnv(string $binary, array $env): array	proc_open + putenv before exec; share with #773 if landed
Env	Mirror ExamplesCompileTest 001 POST pattern (#259)	REQUEST_BODY for POST
Deploy	PHPC_DEPLOY_ROOT optional case	#612 dist layout
Root cause	#764, #776	void include templates; #767 typed array $config

# Manual repro (Docker, apply patches):
composer install && ./script/apply-patches.sh
php bin/phpc.php build --project examples/003-MiniWebApp
cd examples/003-MiniWebApp
QUERY_STRING=route=home REQUEST_METHOD=GET ./.phpc/bin/app | wc -c

Acceptance criteria

./script/ci-local.sh --filter MiniWebAppAotExecuteTest
# After #764 + #747:
MINIWEBAPP_AOT_EXECUTE_GATE=1 ./script/ci-local.sh --filter MiniWebAppAotExecuteTest

Harness (empty bind-mount):

./script/docker-ci-local.sh --filter MiniWebAppAotExecuteTest

No GitHub Actions.

Dependencies

• AOT: MiniWebApp phpc build --project native link fails on master (post-#568/#734) #752 ✅ / AOT: Native user-class object model for phpc build --project #568 ✅ — link
• AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link) #764 — execute blocker (primary)
• Testing: MiniWebAppAotExecuteTest CLI smoke (#485, #676 step 2) #747 — orchestration / unskip matrix
• Testing: MiniWebApp AOT unskip matrix after #568 (orchestrate #454 #485 #478 #610) #676 step 2
• DevEx: miniwebapp-gates stage 4b2 — AOT CLI execute byte probe (#764) #773 — optional CLI helper for local debug

Links

• Testing: MiniWebAppAotExecuteTest CLI smoke (#485, #676 step 2) #747, AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link) #764, AOT: Router render* void methods — template include must emit stdout (#764) #776, Testing: Enable examples-aot-smoke.sh 003-MiniWebApp slice (#676 step 3) #738, Testing: ServeAotTest MiniWebApp routes via phpc serve --aot (blocked #764 execute) #478
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78

[PurHur]

Partial fix merged in #492: SourceBundler now rewrites return-only config includes to $config = … so bundled entry code is reachable. JIT void returns fixed for : void methods. MiniWebApp compile.php still stops at #58 (TYPE_DECLARE_CLASS / method calls) — AOT execute smoke remains skipped until that lands.

[PurHur]

Batch 31: Runtime tracking moved to #539 ( #67 ✅ = lint-first skeleton only). Unskip this test when #539 acceptance criteria pass (after #58 + #145).