Stdlib: json_encode() flags: named parameter rejected — compile error not JSON output (ext/json/php_json.c)

[PurHur]

Category

stdlib · php-src-strict

Problem

json_encode($value, flags: JSON_FORCE_OBJECT) fails at compile/runtime with Too many arguments to function call. Positional json_encode($value, JSON_FORCE_OBJECT) works. Zend accepts the named flags: parameter.

php-src reference

• php/php-src ext/json/php_json.c — php_json_encode(), $flags parameter
• php/php-src ext/json/php_json.h — JSON_FORCE_OBJECT and related flags

Repro

test/repro/maintainer_gap_json_encode_flags_named.php:

<?php
var_export(json_encode(['a' => 1], flags: JSON_FORCE_OBJECT));

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php test/repro/maintainer_gap_json_encode_flags_named.php
php bin/vm.php test/repro/maintainer_gap_json_encode_flags_named.php'

Zend: '{"a":1}'
VM: Too many arguments to function call

Implementation hints (PHP-in-PHP)

• Register json_encode in BuiltinParamNames with flags (and optional depth) — same pattern as Stdlib: header() — named parameters replace/response_code fail at compile (BuiltinParamNames, head.c) #9104 header() named args.
• ext/standard / ext/json VmJson path already handles integer flags once bound.
• No new C runtime.

Done when (php-src-strict)

• Named flags: accepted; output matches positional form
• JSON_THROW_ON_ERROR named constant + named arg smoke (pairs Stdlib: json_decode()/json_encode() with JSON_THROW_ON_ERROR must throw JsonException (ext/json/php_json.c) #9032)
• Compliance guard under test/compliance/cases/stdlib/ or test/repro/

Related

• Stdlib: json_decode()/json_encode() with JSON_THROW_ON_ERROR must throw JsonException (ext/json/php_json.c) #9032 — JSON_THROW_ON_ERROR semantics
• php-in-php: JIT StringJsonEncode — route json_encode() through VmJson PHP not __compiler_json_encode_* LLVM (#1492) #9267, php-in-php: JIT StringJsonDecodeJit — route json_decode()/json_validate() through VmJson PHP not ~2.1k-line LLVM (#1492) #9359 — json php-in-php JIT migration
• North star: Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492

[PurHur]

claim: cursor-agent-lane-b — batch (issues #9646, #10048) — compiler BuiltinParamNames named-arg registration; not ext/json or ext/standard runtime scope despite stdlib label

[PurHur]

Merged via #11089

Fix: BuiltinParamNames registers json_encode as value / flags / depth per php-src stub.

Verification: issue repro + BuiltinParamNamesAliasTest::testJsonEncodeNamedParameters + json_encode_flags_named.phpt green in Docker.