Category

stdlib

Problem

Directory iteration builtins are undefined in this compiler. scandir() exists, but php-src also exposes handle-based directory reading used by frameworks and legacy code:

$dh = opendir('/tmp');
while (($file = readdir($dh)) !== false) { /* … */ }
closedir($dh);

php-src reference

• ext/standard/dir.c — php_opendir, php_readdir, php_closedir, php_rewinddir
• ext/standard/basic_functions.c — function registration
• main/streams/streams.c — php_stream_opendir wrapper

Repro (today)

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php bin/vm.php -r "var_dump(function_exists(\"opendir\"));"
php bin/vm.php -r "\$d = opendir(\".\"); var_dump(\$d);"
'

Zend PHP: bool(true); returns directory resource
This compiler: Call to undefined function opendir() (lib/VM.php)

Same for readdir, closedir, rewinddir.

Scope (this repo)

v1 semantics: POSIX directory handles; skip dir() OOP wrapper (separate issue if needed).

Done when

• Repro opens ., reads at least . and .., closes without leak
• Invalid handle: warning + false (match Zend where applicable)
• ./script/ci-fast.sh --filter opendir green
• script/capability-matrix.php lists four functions as VM yes

Verification

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && vendor/bin/phpunit --filter opendir'

Links

• Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 bootstrap inventory may reference directory walks
• Complements existing scandir() in ext/standard/