php-in-php: VmSleepNative — pure PHP sleep()/usleep() without libc FFI (#1492, basic_functions.c)

[PurHur]

Category

php-in-php · stdlib · bootstrap

Problem

sleep(), usleep(), time_nanosleep(), and time_sleep_until() VM handlers use VmSleepNative — libc sleep(3)/usleep(3)/nanosleep(2) via FFI. With PHP_COMPILER_DISABLE_FFI=1, sleep(0) returns false and usleep(0) is a no-op that does not match Zend's success semantics — breaking rate-limit tests and bootstrap timing probes.

Prefer a compiled PHP busy-wait or monotonic-clock poll (hrtime pure path) for zero/sub-second delays; keep libc FFI as optional fast path.

php-src reference

• php/php-src ext/standard/basic_functions.c — PHP_FUNCTION(sleep), usleep, time_nanosleep, time_sleep_until

Repro

PHP_COMPILER_DISABLE_FFI=1 php bin/vm.php -r 'var_dump(sleep(0));'
PHP_COMPILER_DISABLE_FFI=1 php bin/vm.php -r 'usleep(0); echo "ok\n";'

Observed: bool(false) for sleep(0); usleep silent no-op.

Expected: int(0) for sleep(0); usleep(0) completes without error.

Scope

Path	Work
ext/standard/VmSleepNative.php	VmSleepPure using VmHrtimeNative / compiled poll
ext/standard/sleep.php, usleep.php, time_nanosleep.php, time_sleep_until.php	Fallback routing
JIT/AOT	lib/JIT/Builtin/TimeSleepRuntime.php unchanged unless VM parity requires

Done when

• Repro commands match Zend observable results with FFI disabled
• php-src-strict: negative args still ValueError
• Document FFI lines removed or gated behind available()

Links

• Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 · Stdlib: hrtime() — enum case operand must TypeError not coerce (ext/standard/hrtime.c) #8815 hrtime enum guards · Stdlib: time_nanosleep() / time_sleep_until() — missing (ext/standard/datetime.c) #5180 time_nanosleep JIT

[PurHur]

claim: PHP Runtime → PHP — starting this run.

[PurHur]

Merged via #8927.

Change: Added ext/standard/VmSleepPure.php — pure PHP sleep/usleep/time_nanosleep/time_sleep_until using VmHrtimeNative monotonic polling. VmSleepNative routes to it when libc FFI is disabled (PHP_COMPILER_DISABLE_FFI=1).

Verification:
```bash
./script/docker-exec.sh bash -c 'PHP_COMPILER_DISABLE_FFI=1 php bin/vm.php -r "var_dump(sleep(0));"'

int(0)

./script/docker-exec.sh bash -c 'PHP_COMPILER_DISABLE_FFI=1 php bin/vm.php -r "usleep(0); echo "ok\n";"'

ok

./script/docker-exec.sh ./vendor/bin/phpunit --filter sleep_pure_no_ffi

OK (2 tests)

```