Docs: deploy-web-aot.md quickstart (phpc deploy + PHPC_DEPLOY_ROOT + nginx CGI)

[PurHur]

Problem

#445 is the umbrella production guide. #609 ✅ landed phpc deploy, and #612 / #623 track deploy-root E2E tests — but README still lacks a short, copy-paste path from:

phpc build --project → phpc deploy → PHPC_DEPLOY_ROOT → nginx CGI snippet

Contributors grep issues instead of one doc page.

Goal

Add docs/deploy-web-aot.md (≤200 lines) with:

1. Build + deploy commands for examples/002-StaticWeb (AOT today) and examples/003-MiniWebApp (blocked note → AOT: Native user-class object model for phpc build --project #568)
2. Dist layout table: bin/app, public/, templates/, assets/, phpc.json, README.deploy
3. PHPC_DEPLOY_ROOT — export before running binary; link AOT: Runtime include() of deploy-root PHP via phpc_deploy_path() #623
4. nginx fastcgi_pass / cgi illustrative block (not CI-tested)
5. Local verify checklist: phpc deploy, QUERY_STRING=… ./bin/app, make examples-web-smoke

Link from README “Developing web apps” and lib/Web/ProjectDeploy.php README.deploy template.

Scope

• Doc file + README link
• Cross-link Web: CGI/1.1 request driver (stdin/stdout, env, Status line) #50, Web: FastCGI request loop adapter (nginx / php-fpm compatible) #173, Docs: Production deployment guide (nginx + AOT binary + CGI/FastCGI) #445 (full guide), AOT: Deploy bundle (binary + public assets + phpc.json manifest) #180 (closed → AOT: phpc deploy bundles binary, public/, assets/, and phpc.json into dist/ #609)
• No .github/workflows/* changes

Acceptance criteria

• grep deploy-web-aot README.md finds link
• All commands in doc run on php-compiler:22.04-dev for 002-StaticWeb dist smoke

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev bash -lc '
  phpc deploy examples/002-StaticWeb -o /tmp/static-dist
  test -x /tmp/static-dist/bin/app
  grep PHPC_DEPLOY_ROOT /tmp/static-dist/README.deploy
'

Dependencies

• AOT: phpc deploy bundles binary, public/, assets/, and phpc.json into dist/ #609 — deploy CLI
• Docs: Production deployment guide (nginx + AOT binary + CGI/FastCGI) #445 — parent long-form guide (this doc is the “quickstart” slice)
• AOT: Native user-class object model for phpc build --project #568 — MiniWebApp native binary section marked blocked until green

Links

• lib/Web/ProjectDeploy.php, docs/local-ci-matrix.md (if present)
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 Phase 3

[PurHur]

Batch 41: Runtime deploy includes #623 ✅ closed — link PHPC_DEPLOY_ROOT section to lib/Web/DeployRoot.php + test/unit/Web/DeployIncludeTest.php. MiniWebApp native binary section stays blocked until #568 / unskip matrix #676.