php-in-php: glob/scandir/chmod/touch — delete phpc_fs_dir.c (~760 lines), JIT from ext/standard/VmFsGlob.php

[PurHur]

Category

php-in-php | stdlib

Problem

Directory and path builtins (glob, scandir, chmod, chown, chgrp, touch, utime, …) have PHP VM paths (ext/standard/VmFsGlob.php, VmFs.php) but AOT/JIT still link a large C helper table:

• lib/AOT/runtime/phpc_fs_dir.c — ~760 lines (glob/scandir/chmod/…)
• Registered in lib/AOT/Linker.php (phpc_fs_dir.c)

This duplicates logic already moving PHP-ward and blocks shrinking the C runtime per #1492 / PHP-in-PHP strategy.

php-src reference

• php/php-src ext/standard/dir.c — glob, scandir
• php/php-src ext/standard/filestat.c — chmod, touch, utime
• Treat php-src as semantics reference; implementation belongs in ext/standard/ + JIT lowering

Repro (C dependency today)

grep phpc_fs_dir lib/AOT/Linker.php
wc -l lib/AOT/runtime/phpc_fs_dir.c
# 760 lib/AOT/runtime/phpc_fs_dir.c

./script/docker-exec.sh bash -lc 'source script/ci-defaults.env && make bootstrap-selfhost-link'
# links phpc_fs_dir.o even when VM uses VmFsGlob.php

VM glob() already works via FFI (ext/standard/VmFsGlob.php, #4859); AOT should lower to the same PHP/FFI path, not __phpc_glob_vec C.

Scope (this repo)

Layer	Path
Delete C	lib/AOT/runtime/phpc_fs_dir.c, remove from lib/AOT/Linker.php
JIT/AOT	lib/JIT/Builtin/ handlers calling VmFsGlob / VmFs (thin libc FFI only)
VM	keep ext/standard/glob_.php, scandir.php, chmod_.php, …
Tests	existing JIT/AOT PHPT for glob/scandir; add chmod/touch if missing
Matrix	php script/capability-matrix.php

Done when

• phpc_fs_dir.c removed; ~760 lines deleted from runtime/`
• AOT link succeeds without __phpc_glob_vec / C dir helpers
• glob(), scandir(), chmod() parity tests green on VM + AOT
• ./script/ci-fast.sh --filter 'Glob|Scandir|Chmod' green (or targeted PHPT names)
• No new logic added to runtime/*.c — libc calls stay in PHP FFI shims

Related

• Bootstrap: glob() — native path pattern matching without host \glob() (ext/standard/dir.c) #4859 — VM glob via FFI
• Stdlib: opendir()/readdir()/closedir()/rewinddir() — directory handle API (ext/standard/dir.c parity) #3653 / future phpc_dir.c migration — opendir handle table (~171 lines)
• Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 — shrink C runtime for self-host

[PurHur]

claim: PHP Runtime → PHP — starting this run (#5459: StringFsGlobVecJit for glob_vec/scandir_vec/strvec_free, shrink phpc_fs_dir.c, merge if green).

[PurHur]

Merged phase 1 via #6953.

PHP path: lib/JIT/Builtin/StringFsGlobVecJit.php + StringFsGlob::ensureLinked() — __phpc_glob_vec, __phpc_scandir_vec, __phpc_strvec_free LLVM from PHP (libc FFI only).

C shrink: removed vec collectors + dead __phpc_file_vec from lib/AOT/runtime/phpc_fs_dir.c (−168 lines, 693→525). Remaining symbols (__phpc_stat, chown/chgrp, tempnam, legacy __phpc_glob/__phpc_scandir) stay for follow-up runs.

Verification (green):

• vendor/bin/phpunit test/unit/VmFsGlobTest.php — OK
• vendor/bin/phpunit test/compliance/JITTest.php --filter "glob_jit|glob_native|glob_onlydir|glob_scandir" — OK
• php bin/jit.php / php bin/vm.php glob smoke — OK

Known blockers (pre-existing): AOT glob_scandir fixture compile exit 139; full phpc_fs_dir.c deletion still open on this issue.