PHP 8.6 反射属性可读写检测怎么用：isReadable 与 isWritable 的判断边界

做一个通用属性映射器时，最容易误判的一件事是：看到 ReflectionProperty::isPublic() 为真，就默认外部代码既能读也能写。PHP 8.1 的 readonly 和 PHP 8.4 的非对称可见性已经打破了这个假设，属性 Hooks 又让一次读写可能进入自定义逻辑。PHP 8.6 的 isReadable() 与 isWritable() 正是用来回答“从某个作用域看，这个操作是否被允许”。

先把 scope 和 object 两个输入分开

两个方法的签名很短，但参数语义不能省略：

$property = new ReflectionProperty(Account::class, 'email');

$canRead = $property->isReadable(null, $account);
$canWrite = $property->isWritable(AccountMapper::class, $account);

scope 是字符串类名或 null。它不是被检查属性的声明类，而是“假设操作从哪里发起”。object 是可选实例；缺少它时，反射只能依据定义判断，无法知道某个实例的属性是否已经初始化。

用 scope 判断 public、private(set) 与 readonly 的访问边界

旧式写法只看 isPublic()，在 PHP 8.6 里不够用了。读权限和写权限是两条独立的判断链：一个属性可能公开可读，却因为 readonly 或 private(set) 不允许从当前作用域写入。

final class Account
{
    public string $name;
    public readonly string $id;
    public private(set) string $email;
}

$ref = new ReflectionClass(Account::class);
$email = $ref->getProperty('email');

var_dump($email->isReadable(null));
var_dump($email->isWritable(null));
var_dump($email->isWritable(Account::class));

这里不要把输出写死成“公开属性永远可写”。null 模拟类外代码；传入 Account::class 则模拟该类方法内部。self::class 适合封装在通用基类或映射器方法里，避免把类名复制成字符串后失去重构安全性。

这一步的核对标准很简单：需要读就调用 isReadable()，需要写就调用 isWritable()；不要用一个布尔结果代替另一个操作。

hooks、readonly 与未初始化要按对象状态复核

属性 Hooks 把属性分成 backed 和 virtual 两类。virtual 属性没有存储值，只有定义了对应的 get 或 set hook 才存在该操作；backed 属性则可以保留默认读写，同时在 hook 中校验或转换值。

final class Profile
{
    public string $displayName;

    public string $label {
        get => strtoupper($this->displayName);
    }

    public readonly string $token;
}

$profile = new Profile();
$label = new ReflectionProperty(Profile::class, 'label');
$token = new ReflectionProperty(Profile::class, 'token');

var_dump($label->isReadable(null, $profile));
var_dump($label->isWritable(null, $profile));
var_dump($token->isWritable(null, $profile));

传入 $profile 后，读取判断还会关心属性是否已初始化以及是否被 unset()；写入判断则会考虑 readonly 是否已经完成初始化。把这些参与项记成 get hook、set hook、初始化状态 和 magic __get/__set，比只看修饰符更接近 RFC 的判定模型。对于 __get、__set 和 __isset，RFC 也规定了它们如何参与结果，所以不要只根据修饰符做自己的简化版推断。

把检测结果当作前置提示，不当作访问成功承诺

true 表示反射根据已知规则判断该操作被允许，但它没有替你执行 hook。一个 get 或 set hook 可以根据业务条件抛出异常，反射无法提前运行这段任意逻辑。PHP 官方 RFC 还特别保留了另一条边界：某些内置类虽然实际表现为不可变，却没有使用 readonly 或非对称写可见性，反射不一定能识别。

因此在映射器里更稳妥的写法是先用检测结果筛掉明显不匹配的字段，再对真实的 getValue() 或 setValue() 保留异常处理。PHP 8.6.0beta2 属于测试构建，升级试跑应放在隔离环境，不要直接替换生产运行时。

相关问题

isReadable() 能代替 isInitialized() 吗？

不能。前者回答从指定作用域是否可读；后者只回答对象上的属性是否已经初始化。需要判断未初始化风险时，两者应按场景分别使用。

不传 object 会不会更安全？

它只会避开实例状态判断，并不会让实际读写更安全。没有对象时得到的是静态层面的可行性，真正访问实例仍可能受初始化、unset 或 hook 异常影响。

readonly 属性什么时候可能可写？

判断还要看作用域和对象状态。对象尚未初始化、当前操作位于允许初始化的范围内等情况可能得到不同结果；已经初始化后的再次写入不能仅靠 public 修饰符放行。

把 scope、object、属性 Hooks 和当前对象状态分开记录，反射检测就能成为有用的前置判断，而不是一条容易误读的“万能通行证”。