Testing: CgiDriverTest VM smoke for bin/cgi.php (parent #50)

[PurHur]

Problem

#50 tracks bin/cgi.php (CGI/1.1 stdin/env driver). There is no PHPUnit harness proving a compiled or VM script produces correct Status: + headers + body when invoked like nginx would (env vars only, no TCP).

Without a test, CGI regressions slip past ci-fast.sh until manual nginx setup.

Goal

test/real/CgiDriverTest.php (or PHPT under test/real/cases/):

1. Phase A (VM): After Web: CGI/1.1 request driver (stdin/stdout, env, Status line) #50 lands bin/cgi.php, run examples/001-SimpleWeb/example.php with:
   • REQUEST_METHOD=GET, QUERY_STRING=name=CgiTest, SCRIPT_NAME=/example.php
   • Assert stdout contains Status: 200, Content-Type: text/html, and CgiTest in body
2. Phase B (AOT, optional): When Testing: ExamplesCompileTest AOT execute smoke (002-StaticWeb build + run) #247-style execute smoke exists for 001, repeat with compiled binary behind thin shim (document in test skip until green)

Skip when PHP_COMPILER_SKIP_SERVE_TESTS=1 (same as ServeTest).

Implementation hints

Piece	Notes
Runner	proc_open on php bin/cgi.php <path> with env array — no loopback
Fixture	Start from 001-SimpleWeb; avoid MiniWebApp until #568
Parent	#50 implements driver; this issue only tests
Docs	One curl-free recipe in docs/deploy-web-aot.md stub (#635)

Acceptance criteria

./script/ci-fast.sh --filter CgiDriverTest

Blocked until #50 — use markTestSkipped('bin/cgi.php not shipped (#50)') until then.

Docker:

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

Dependencies

• Web: CGI/1.1 request driver (stdin/stdout, env, Status line) #50 — CGI driver implementation (open)
• Stdlib: http_response_code() for 404/500 and API status #252 — Status line from response context (closed)
• AOT: Per-request superglobal refresh in native binary (not compile-time bake) #201 — AOT superglobals (closed) for Phase B

Links

• lib/Web/DevServer.php env keys to mirror
• Web: FastCGI request loop adapter (nginx / php-fpm compatible) #173 FastCGI (future)

[PurHur]

Status sync (batch 40): Parent #50 ✅ closed — bin/cgi.php + lib/Web/CgiDriver.php ship on master. VM-phase tests in test/real/CgiDriverTest.php should run in ci-fast.sh (first PHPUnit batch, @group cgi).

Remaining scope for this issue:

• Phase A VM tests for 001-SimpleWeb GET/POST
• Phase B: extend to Testing: CgiDriverTest MiniWebApp PATH_INFO routes via bin/cgi.php #666 MiniWebApp PATH_INFO cases
• Phase C: AOT binary via Web: AOT CGI wrapper for phpc-built binaries (production nginx spawn) #665 wrapper (skip until AOT: Native user-class object model for phpc build --project #568)

Remove stale markTestSkipped('bin/cgi.php not shipped') if any remains.