AOT: phpc deploy bundles binary, public/, assets/, and phpc.json into dist/

[PurHur]

Problem

#585 ✅ added PHPC_DEPLOY_ROOT / phpc_deploy_path() so AOT binaries can include templates at runtime when sources are not beside the executable. #594 ✅ serves /assets/* from a manifest assets/ directory under phpc serve.

There is still no packaging CLI that produces a production-shaped tree contributors can copy behind nginx/CGI (#180, #445). Today authors hand-copy public/, assets/, and the binary.

Goal

phpc deploy examples/003-MiniWebApp -o dist/003-miniwebapp
# or: phpc build --project … && phpc deploy --from-build

Emit:

dist/003-miniwebapp/
  bin/app                 # AOT binary from phpc.json "binary"
  public/                 # copied docroot (index.php may be omitted if fully bundled)
  assets/                 # copied when manifest has "assets"
  templates/              # optional copy when not fully bundled into binary
  phpc.json
  README.deploy           # env vars: PHPC_DEPLOY_ROOT, QUERY_STRING, PHP_COMPILER_DEBUG

Scope

• bin/phpc.php subcommand deploy (or bin/deploy.php wrapper)
• Read manifest via lib/Web/ProjectManifest.php (entry, binary, public, assets)
• Copy trees with safe path checks (no .. traversal)
• Document PHPC_DEPLOY_ROOT=<dist> for template includes rewritten by SourceBundler (AOT: PHPC_DEPLOY_ROOT for runtime template includes in deployed binaries #585)
• test/unit/PhpcDeployTest.php — temp project → dist layout assertions (no LLVM required for copy-only path)

Acceptance criteria

./phpc deploy examples/002-StaticWeb -o /tmp/static-dist
test -x /tmp/static-dist/bin/app -o -f /tmp/static-dist/phpc.json

When #568 lands, extend fixture to examples/003-MiniWebApp and assert assets/style.css + templates/layout.php exist in dist.

Harness (Docker):

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  ./phpc deploy examples/002-StaticWeb -o /tmp/static-dist

No GitHub Actions.

Dependencies

• AOT: Deploy bundle (binary + public assets + phpc.json manifest) #180 — parent deploy bundle tracker (this issue is the CLI slice)
• AOT: Project build mode (entry file + dependency graph) #59 / AOT: phpc build --project preflight validates include graph before compile #504 — phpc build --project + dry-run graph (binary must exist or deploy runs build first)
• AOT: Native user-class object model for phpc build --project #568 — MiniWebApp native link before full 003 bundle is meaningful
• Web: CGI/1.1 request driver (stdin/stdout, env, Status line) #50 / Web: FastCGI request loop adapter (nginx / php-fpm compatible) #173 — optional CGI/FastCGI wrapper script in dist (follow-up)

Links

• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78
• lib/Web/DeployRoot.php, test/unit/DeployRootTest.php
• Docs: Production deployment guide (nginx + AOT binary + CGI/FastCGI) #445 production deployment doc

[PurHur]

Merged via #615: phpc deploy -o bundles bin/app, phpc.json, public/, assets/, templates/, and README.deploy.

[PurHur]

Scope note (batch 36): phpc deploy CLI and lib/Web/ProjectDeploy.php are on master (bin/phpc.php subcommand, test/unit/PhpcDeployTest.php). Remaining work for this issue:

• Document in README / Docs: Production deployment guide (nginx + AOT binary + CGI/FastCGI) #445 deploy guide
• make deploy-smoke or wire PhpcDeployTest into ci-fast.sh
• phpc.json optional "templates" key (today copies templates/ when directory exists)
• Full 003-MiniWebApp dist E2E after AOT: Native user-class object model for phpc build --project #568 — tracked as AOT: MiniWebApp dist-layout smoke with PHPC_DEPLOY_ROOT (post #609 deploy) #612

Consider closing this issue when docs + Makefile target land; keep #180 as parent bundle tracker.