DevEx: phpc build smoke in ExamplesCompileTest (unified CLI path)

[PurHur]

Problem

Contributors and docs steer users to ./phpc build, but test/unit/ExamplesCompileTest.php only shells out to bin/compile.php for AOT lint. Wrapper regressions in bin/phpc.php (argv forwarding, env, -o handling) are invisible to the examples CI gate.

test/aot/ExampleWebAotTest.php compiles via bin/compile.php as well — not via phpc build.

Goal

Add at least one examples test that runs ./phpc build -o <tmp> examples/002-StaticWeb/example.php and executes the binary (same assertion as #247 / ExampleWebAotTest::testStaticWebExampleFile).

Keep existing bin/compile.php -l paths for speed; this is an additional smoke, not a full replacement.

Scope

• testPhpcBuildSmoke002StaticWeb() in ExamplesCompileTest or shared trait with ExampleWebAotTest
• @group llvm — skip when toolchain missing
• Assert stdout contains Hello World and exit 0
• Runs in script/ci-local.sh LLVM stage

Acceptance criteria

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  vendor/bin/phpunit --group llvm --filter 'ExamplesCompileTest.*PhpcBuild'

Verification (local only)

Do not require GitHub Actions.

Dependencies

• Testing: ExamplesCompileTest AOT execute smoke (002-StaticWeb build + run) #247 (ExamplesCompileTest AOT execute — overlapping scope; close together or merge tests)
• DevEx: phpc CLI wrapper (serve, build, test subcommands) #159 phpc CLI ✅

Related

• Examples: Minimal phpc.json for 001-SimpleWeb and 002-StaticWeb #274 example phpc.json stubs
• Docs: examples/README — phpc/vm/aot run matrix per example folder #262 examples/README run matrix
• 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 ROADMAP Phase 0

[PurHur]

Closed via merged PR #355.