Stdlib: file_get_contents() filename: named parameter rejected (ext/standard/file.c)

[PurHur]

Category

stdlib · php-src-strict

Problem

php-src names the first parameter of file_get_contents() filename. Zend accepts:

file_get_contents(filename: 'php://memory'); // string (possibly empty)

VM rejects with Unknown named parameter $filename. Positional file_get_contents('php://memory') works.

Distinct from #9308 (offset/length slice semantics — verified green on master 2026-06-19).

php-src reference

• php/php-src ext/standard/file.c — PHP_FUNCTION(file_get_contents)
• php/php-src ext/standard/basic_functions.stub.php — filename, use_include_path, context, offset, length
• Named binding: php/php-src Zend/zend_compile.c

Repro (failure today)

<?php
var_export(file_get_contents(filename: 'php://memory'));
echo "\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 $filename
'

Call	Zend PHP 8.2+	VM today
file_get_contents(filename: 'php://memory')	''	fatal ❌
positional	''	'' ✅

Scope (this repo)

Path	Work
lib/BuiltinParamNames.php / patches	Register filename + optional arg names
lib/Compiler.php, lib/VM/NamedArgs.php, lib/JIT/NamedArgs.php	Named binding
ext/standard/file_get_contents.php	handler after wiring
Tests	test/compliance/cases/stdlib/file_get_contents_filename_named.phpt

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

Done when

• Repro runs without fatal on VM
• Named context: / offset: / length: bind to correct slots when added in follow-up
• ./script/ci-fast.sh --filter file_get_contents_filename_named green

Related

• Stdlib: file_get_contents() offset/length args return false — must read slice (ext/standard/file.c) #9308 offset/length slice · Stdlib: array_search() needle:/haystack:/strict: named parameters rejected (ext/standard/array.c) #10041 array_search named · Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492

[PurHur]

claim: cursor-agent-lane-b — starting this run (compiler named-args wiring for file_get_contents filename:; BuiltinParamNames/Compiler scope per issue body)

[PurHur]

Merged via #10738.

Fix: Register file_get_contents parameter names in lib/BuiltinParamNames.php so filename: binds at compile time (php-src basic_functions.stub.php).

Verification:

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php test/repro/named_file_get_contents.php
php bin/vm.php test/repro/named_file_get_contents.php
vendor/bin/phpunit --filter file_get_contents_filename_named
'

OK — named filename: reads fixture; no Unknown named parameter fatal.