Stdlib: random_int() min:/max: named parameters rejected (ext/random/random.c)

[PurHur]

Category

stdlib · php-src-strict

Problem

php-src names random_int() parameters min and max. Zend accepts:

random_int(min: 1, max: 3); // int in [1,3]

VM rejects with Unknown named parameter $min. Positional random_int(1, 3) works.

php-src reference

• php/php-src ext/random/random.c — php_random_int
• php/php-src ext/random/random.stub.php — min, max parameter names
• Named binding: php/php-src Zend/zend_compile.c

Repro (failure today)

<?php
echo random_int(min: 1, max: 3), "\n";

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php repro.php
php bin/vm.php repro.php
# VM: Unknown named parameter $min
'

Call	Zend PHP 8.2+	VM today
random_int(min: 1, max: 3)	int in range	fatal ❌
positional	int in range	int in range ✅

Scope (this repo)

Path	Work
patches/php-types*.patch / builtin arginfo	Export min/max for random_int
lib/Compiler.php, lib/VM/NamedArgs.php, lib/JIT/NamedArgs.php	Named binding
ext/standard/random_int.php (or random module)	handler after arg wiring
Tests	test/compliance/cases/stdlib/random_int_named.phpt

PHP-in-PHP first — no new runtime/*.c.

Done when

• Repro runs without fatal; result in [1,3] on VM
• max < min still throws ValueError like Zend
• ./script/docker-exec.sh -- vendor/bin/phpunit --filter random_int_named green

Related

• Stdlib: mt_rand() / srand() / getrandmax() / lcg_value() — Mersenne Twister PRNG (ext/standard/php_rand.c parity) #3295 mt_rand parity · Stdlib: hash_pbkdf2()/hash_hmac() named parameters rejected — Unknown named parameter (ext/hash/hash.c) #10013 hash_hmac named · Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492

[PurHur]

claim: cursor-agent-lane-b — batch (issues #10028, #10043, #10126)

[PurHur]

Merged via #10970.

Fix: Register min / max in BuiltinParamNames.php for random_int() (php-src random.stub.php).

Verification: maintainer_gap_random_int_named.php prints ok; VMTest --filter random_int_named green.