php-in-php: lib/AOT/Linker.php runtime bundle audit — keep phpc_progress.c thin, track superglobals/phpc_stream/phpc_gc deletions #7389

Category

php-in-php | bootstrap

Problem

AOT link still pulls four hand-written C translation units from lib/AOT/runtime/ plus hash_crypto_jit_runtime.c. Several deletion tracks exist (#5330, #5343, #5315, #7189), but there is no umbrella issue tying linker inclusion to measurable line-count removal — workers can land PHP replacements without deleting the C object from lib/AOT/Linker.php::RUNTIME_SOURCES, leaving dead ABI forever.

Current linker set (lib/AOT/Linker.php):

North-star: semantics live in lib/, ext/, lib/JIT/; C is trampoline/ABI only.

php-src reference

• Behavioral reference: Zend SAPI (sapi/cgi/cgi_main.c), streams (main/streams/streams.c), GC (Zend/zend_gc.c), hash (ext/hash/hash.c)
• This issue tracks deletion of our C shims, not re-porting php-src C verbatim

Repro (audit today)

docker info >/dev/null
./script/docker-exec.sh -- bash -lc '
  wc -l lib/AOT/runtime/*.c lib/JIT/Builtin/hash_crypto_jit_runtime.c
  rg -n "RUNTIME_SOURCES|phpc_" lib/AOT/Linker.php | head -20
'

Any PR that migrates behavior PHP-ward must show lines removed from the matching .c file and drop it from Linker.php when the PHP path is default for VM+JIT+AOT.

Scope (this repo)

Forbidden: new logic in runtime/*.c when the same work can compile through the existing PHP pipeline.

Done when

• Child issues (php-in-php: CGI superglobal refresh — delete superglobals_refresh.c (~2623 lines), populate in lib/Web/ #5330, php-in-php: stream handle registry — delete phpc_stream.c (~1059 lines), FILE* table in ext/standard #5343, php-in-php: gc_collect_cycles() JIT — delete phpc_gc.c (~368 lines), sweep in lib/VM/CycleCollector.php #5315, php-in-php: hash_crypto_jit_runtime.c (~800 lines) — delete after VmHashNative JIT/AOT link (#5989 phase 2) #7189) each note linker deletion step in Done when
• When a child closes, this audit table updated in comment (lines remaining per .c)
• phpc_progress.c stays ≤50 lines (SIGSEGV handler only; progress in ProgressNoteRuntime.php)
• ./script/ci-local.sh green after each C deletion (full gate before merge)

Verification

make bootstrap-selfhost-link
./script/docker-exec.sh -- bash -lc './script/ci-local.sh --filter AotTest'

Related

• Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 self-host / shrink C runtime
• php-in-php: CGI superglobal refresh — delete superglobals_refresh.c (~2623 lines), populate in lib/Web/ #5330, php-in-php: superglobals_refresh.c FILES/multipart parser — migrate bracket parser to lib/Web (phase 2 of #5330) #7302, php-in-php: stream handle registry — delete phpc_stream.c (~1059 lines), FILE* table in ext/standard #5343, php-in-php: gc_collect_cycles() JIT — delete phpc_gc.c (~368 lines), sweep in lib/VM/CycleCollector.php #5315, php-in-php: hash_crypto_jit_runtime.c (~800 lines) — delete after VmHashNative JIT/AOT link (#5989 phase 2) #7189, php-in-php: phpc_progress.c — keep SIGSEGV handler as thin C only; progress buffer stays in ProgressNoteRuntime.php #7360