AOT: MiniWebApp dist-layout smoke with PHPC_DEPLOY_ROOT (post #609 deploy)

[PurHur]

Problem

#585 ✅ rewrites template __DIR__ includes to phpc_deploy_path() in bundled sources. DeployRootTest proves a minimal temp project. There is no end-to-end gate that:

1. Builds / deploys examples/003-MiniWebApp into a dist directory (AOT: phpc deploy bundles binary, public/, assets/, and phpc.json into dist/ #609 ✅)
2. Sets PHPC_DEPLOY_ROOT to that dist
3. Runs the native binary with CGI env and asserts HTML needles from templates/layout.php

Without this, production deploy regressions slip past VM phpc serve and unit tests.

Goal

test/aot/MiniWebAppDeployLayoutTest.php (@group llvm, @group aot-link, @group miniwebapp):

phpc deploy examples/003-MiniWebApp -o /tmp/mini-dist   # after #568 link
PHPC_DEPLOY_ROOT=/tmp/mini-dist QUERY_STRING=route=home REQUEST_METHOD=GET \
  /tmp/mini-dist/bin/app
# stdout contains MiniWebApp + layout partial

PATH_INFO variant: PATH_INFO=/hello + QUERY_STRING=name=Deploy.

While blocked: markTestSkipped → #568.

Implementation hints

Piece	File	Notes
Test	test/aot/MiniWebAppDeployLayoutTest.php	Copy env helpers from DeployRootTest
Deploy	lib/Web/ProjectDeploy.php	Assert templates/, public/, assets/ copied
Includes	#623 ✅	Runtime phpc_deploy_path() for templates
CI	script/ci-local.sh	@group aot-link phase after ExamplesCompileTest
CGI	#682	Optional second test via cgi-wrapper in dist

Harness

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

Acceptance criteria

• Test file exists and is discovered by PHPUnit
• Passes when AOT: Native user-class object model for phpc build --project #568 green; skipped otherwise with linked issue
• phpc deploy dist contains bin/app, templates/, README.deploy

Dependencies

• AOT: phpc deploy bundles binary, public/, assets/, and phpc.json into dist/ #609 ✅ — phpc deploy
• AOT: Runtime include() of deploy-root PHP via phpc_deploy_path() #623 ✅ — runtime deploy includes
• AOT: Native user-class object model for phpc build --project #568 — native link for Router
• Testing: MiniWebApp AOT unskip matrix after #568 (orchestrate #454 #485 #478 #610) #676 — orchestration (after Testing: ExamplesCompileTest @group miniwebapp for 003-MiniWebApp (skipped until green) #454 / Testing: MiniWebApp AOT binary CLI execute smoke (tracked in #747, blocked #764) #485)

Verification

Local/Docker only — not GitHub Actions.

Links

• docs/deploy-web-aot.md (Docs: deploy-web-aot.md quickstart (phpc deploy + PHPC_DEPLOY_ROOT + nginx CGI) #635 ✅)
• Docs: Production deployment guide (nginx + AOT binary + CGI/FastCGI) #445 production guide
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 Phase 3/4