Stdlib: ReflectionProperty::getHooks() / setHook() — PHP 8.4 property hooks reflection (ext/reflection/php_reflection.c)

[PurHur]

Category

stdlib · php-src-strict · spec refresh 2026-06-20

Problem

PHP 8.4 ReflectionProperty::getHooks(): array and setHook(string $name, Closure $hook) expose property hook callables for introspection. This compiler lowers hooks to __phpc_property_* methods (#3145) but ReflectionProperty has no getHooks / setHook builtins — method_exists($rp, 'getHooks') is false under bin/vm.php.

Frameworks (Symfony PropertyInfo, Laravel attribute scanners) need hook introspection separate from #4469 getValue/setValue and #4806-adjacent #10392 isset/empty semantics.

php-src reference

• php/php-src ext/reflection/php_reflection.c — ReflectionProperty::getHooks, setHook
• php/php-src ext/reflection/php_reflection.stub.php — PHP 8.4 signatures
• php/php-src Zend/zend_property_hooks.c — hook storage
• Compiler metadata: lib/SourcePreprocessor/PropertyHooks.php, lib/VM.php linkPropertyHooks

Repro

Commit test/repro/maintainer_reflection_property_gethooks.php:

<?php
declare(strict_types=1);

class Box {
    public string $label {
        get => strtoupper($this->label);
        set (string $v) { $this->label = $v; }
    }
    private string $label = 'hi';
}

$rp = new ReflectionProperty(Box::class, 'label');

echo method_exists($rp, 'getHooks') ? "getHooks yes\n" : "getHooks no\n";
echo method_exists($rp, 'setHook') ? "setHook yes\n" : "setHook no\n";

if (method_exists($rp, 'getHooks')) {
    $hooks = $rp->getHooks();
    ksort($hooks);
    echo implode(',', array_keys($hooks)), "\n";
}

$b = new Box();
echo $b->label, "\n";

if (method_exists($rp, 'setHook')) {
    $rp->setHook('get', fn() => 'OVERRIDE');
    echo $b->label, "\n";
}

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

Check	Zend PHP 8.4+	VM today
method_exists(..., 'getHooks')	true	false ❌
method_exists(..., 'setHook')	true	false ❌
getHooks() keys	get, set	n/a
Read $b->label before override	HI	may work via hooks
After setHook('get', …)	OVERRIDE	n/a

Scope (PHP-in-PHP)

Area	Path
VM builtins	ext/standard/VmReflection.php — ReflectionProperty::getHooks, setHook
Registry	lib/VM/BuiltinClasses.php — register methods on ReflectionProperty
Metadata	Map hook callables from ClassProperty / staticPropertyHooks on ClassEntry
Tests	test/compliance/cases/stdlib/reflection_property_hooks.phpt
Matrix	script/capability-matrix.php
JIT/AOT	VM v1; defer native lowering

Done when (php-src-strict)

• Repro: both methods exist; getHooks() returns get + set entries
• setHook('get', $closure) changes subsequent reads on live object
• Invalid hook name → ValueError like Zend
• ./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && vendor/bin/phpunit --filter reflection_property_hooks' green
• ./script/ci-fast.sh --filter reflection_property_hooks green

Related

• Language: PHP 8.4 property hooks — get/set on properties (Zend parity) #3145 property hooks · Stdlib: ReflectionProperty — attributes + type + visibility parity (ext/reflection/php_reflection.c) #4384 ReflectionProperty types · Stdlib: ReflectionProperty::getValue()/setValue() — static/instance + TypeError/ReflectionException parity (ext/reflection/php_reflection.c) #4469 getValue/setValue · Language: property hook isset()/empty() must not invoke get hook (Zend/zend_property_hooks.c) #10392 isset/empty must not invoke get hook · Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492

[PurHur]

Spec refresh 2026-06-20 (t): expanded repro with setHook override path, Zend comparison table, compliance filter commands, cross-link #10392 (isset/empty must not invoke get hook).

[PurHur]

claim: PHP Compiler STD Lib — starting this run

[PurHur]

Merged via #17258.

Fix: ReflectionProperty::getHooks() now keys results as get/set (not 0/1). Added getHook(PropertyHookType) returning ReflectionMethod with \$prop::get display name.

Note: php-src master has no setHook() in php_reflection.stub.php — only getHooks/getHook.

Verification (PHP_COMPILER_PROFILE=8.4):

• php bin/vm.php test/repro/maintainer_gap_reflection_property_gethooks.php → get,set + getHook-rm
• php bin/vm.php test/compliance/cases/reflection/reflection_property_hook_gethooks_keys.phpt → green
• vendor/bin/phpunit --filter reflection_property_hook_gethooks → OK
• php bin/compile.php -l on compliance phpt → compile_ok