Language: (array) cast on backed enum case — must yield name/value array not backing list (Zend/zend_enum.c)

[PurHur]

Category

language · php-src-strict

Problem

Casting a backed enum case to array must produce an associative array with name and value keys (case name + backing scalar). This compiler coerces the case to its backing scalar and wraps it in a list ([0 => backing]), which is wrong shape and wrong semantics.

php-src reference

• php/php-src Zend/zend_enum.c — zend_enum_cast_object / array cast handler
• php/php-src Zend/zend_operators.c — cast-to-array on object zvals

Repro

test/repro/maintainer_gap_enum_array_cast.php:

<?php
enum E: int { case A = 1; case B = 2; }
var_export((array) E::A);
echo "\n";
var_export((array) E::B);
echo "\n";

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

Engine	(array) E::A
Zend PHP 8.2	array('name'=>'A','value'=>1)
VM today	array(0=>1) ❌

Scope (PHP-in-PHP)

Path	Work
lib/VM/EnumCaseSupport.php	(array) cast handler for enum-case zvals
lib/VM.php / cast opcodes	Route CAST_ARRAY on enum cases
lib/Compiler.php	Compile-time (array) on known enum case if optimized
JIT/AOT	Shared cast helper

Done when (php-src-strict)

• Repro var_export matches Zend for int- and string-backed enums
• Pure (unit) enums: (array) on case → array('name'=>'CaseName') only
• Compliance test/compliance/cases/language/enum_array_cast.phpt green

Related

• Stdlib: get_object_vars() on backed enum case — name/value array not TypeError (ext/standard/var.c) #8804 get_object_vars on enum case · Runtime: $GLOBALS must preserve enum case objects — not backing scalars (Zend/zend_hash.c) #9436 enum zval preservation · Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492

[PurHur]

claim: lane-c-worker — starting this run

[PurHur]

Unclaiming — repro green on master (backed + unit enum array cast + compliance enum_array_cast_*.phpt). No code change needed.

[PurHur]

Verified fixed on master (2026-06-23, lane C audit). Repro green via ./script/docker-exec.sh — see #10337 run 4 probe table.