Bootstrap: ext/zip/ module skeleton — register ZipArchive for self-host (M4)

[PurHur]

Category

bootstrap · stdlib

Problem

Full ZipArchive parity is tracked in #3337, but self-host/bootstrap inventory needs an ext/zip/ module skeleton (like #5839 ext/filter/ and #5695 mbstring) so workers can register classes/functions without bolting everything into ext/standard/Module.php.

Today: class_exists('ZipArchive') is false; no ext/zip/ tree.

php-src reference

• php/php-src ext/zip/php_zip.c — ZipArchive class, zip_open helpers
• php/php-src ext/zip/zip_stream.c — stream wrapper (follow-up)

Repro (today)

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php8.2 -r "var_export(class_exists(\"ZipArchive\")); echo PHP_EOL;"
php bin/vm.php -r "var_export(class_exists(\"ZipArchive\")); echo PHP_EOL;"
ls ext/zip 2>/dev/null || echo "no ext/zip/"
'

Check	Zend	VM today
class_exists('ZipArchive')	true (ext/zip enabled)	false
ext/zip/Module.php	n/a	missing

Scope (this repo)

Path	Work
ext/zip/Module.php	New module; register ZipArchive stub class + method placeholders delegating to phase-2 impl
ext/zip/BuiltinClasses.php	ZipArchive VM builtin skeleton
Module loader	Wire ext/zip beside ext/intl / ext/filter
script/bootstrap-inventory.php	Include ext/zip/* paths
Docs	Link implementation body to #3337 (open/add/extract semantics)

v1 skeleton: class_exists true; ZipArchive::open() may LogicException “not implemented” until #3337 — same pattern as filter skeleton #5839.

Implement registration in PHP; libzip calls via thin FFI only when #3337 lands — no permanent logic in runtime/*.c.

Done when

• ext/zip/Module.php loads without duplicate-registration fatal
• class_exists('ZipArchive') true on VM
• php script/bootstrap-inventory.php --check lists ext/zip/
• Existing CI unchanged (stubs documented in matrix)

Related

• Stdlib: ext/zip — ZipArchive open/add/extract (ext/zip parity) #3337 ZipArchive behavior · Bootstrap: ext/filter/ module skeleton — register filter_var/filter_list for self-host (M4) #5839 filter skeleton pattern · Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 · Milestone: Self-host — compile php-compiler with php-compiler (bootstrap) #212

[PurHur]

claim: cursor-agent-lane-b — starting this run

[PurHur]

lane C note: #5869 is lane B (5869 % 3 = 1), not lane C — no action here.

[PurHur]

Merged via #5959.

Verification:

• vendor/bin/phpunit --filter ZipModuleTest — OK (1 test, 2 assertions)
• php bin/vm.php -r 'var_export(class_exists("ZipArchive"));' → true
• php script/bootstrap-inventory.php --check lists ext/zip/BuiltinClasses.php and ext/zip/Module.php

ZipArchive open/extract behavior remains in #3337.