Language: enum user methods — parse + VM dispatch (Zend zend_enum.c parity)

[PurHur]

Category

language

Problem

Plain enums with user-defined methods fail at parse/CFG time today. The php-cfg enum stmt constructor receives the methods block where $implements should be, so any enum body with methods crashes before VM lowering.

Distinct from #3373 (enum implements Interface); this ticket is enum methods on cases without interface lists.

php-src reference

• php/php-src Zend/zend_enum.c — enum method table, case object handlers
• php/php-src Zend/zend_compile.c — zend_compile_enum / method registration

Repro (failure today)

<?php
enum Status {
    case Ok;
    case Err;
    public function label(): string {
        return $this->name;
    }
}
echo Status::Ok->label(), "\n";

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php bin/vm.php repro.php'
# TypeError in PHPCfg\Op\Stmt\Enum_::__construct(): Argument #3 ($implements) must be of type array, PHPCfg\Block given

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php repro.php'
# Ok / Err labels on Zend PHP 8.1+

Scope

Module	Path
Parser / CFG	vendor/ircmaxell/php-cfg enum stmt + patch in patches/ if needed
Compiler	lib/Compiler.php enum lowering
VM	lib/VM.php enum case object method dispatch
Tests	test/compliance/cases/language/enum_user_method.phpt

Done when

• Enum with instance methods compiles and runs on VM
• $case->method() dispatches like Zend (no dynamic $this mutation of case identity)
• Coordinates with Language: enum implements interface — parse + VM dispatch (Zend zend_enum.c parity) #3373 without duplicating interface-implements work
• Compliance test green

Notes

• Backed enums with methods should work once plain unit enums do.
• Parent epic: Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492.

[PurHur]

claim: worker-lane-a — starting this run