PHP 8.4 asymmetric visibility 怎样让 public 读与 protected 写分开

如果一个属性需要让调用方读取，却只允许当前类或子类更新，PHP 8.4 可以直接把读写权限写在属性声明上：public protected(set) string $status。这样既保留公开读取，也不会把任意赋值入口暴露给类外代码。

官方地址：https://www.php.net/manual/en/language.oop5.visibility.php

用 public protected(set) 把读取和写入拆开

传统的 protected 属性会连读取也限制在类层级内，外部调用者通常只能通过 getter 获取值。PHP 8.4 的非对称可见性把两件事分开：前面的 public 是 get 范围，括号中的 protected(set) 是 set 范围。外部可以读，当前类和子类可以写。

status = $status;
    }
}

$account = new Account('active');
echo $account->status; // 允许：外部读取。
// $account->status = 'disabled'; // 错误：外部没有 protected 写权限。
?>

如果读取范围本来就是 public，可以省略前面的 public，写成 protected(set) string $status。但在团队代码里保留完整写法更直观，读写方向一眼可见。

让子类更新状态，类外只拿到结果

protected(set) 的价值在于把写入入口放进继承层。子类可以提供带业务语义的方法，而调用方只负责读取结果。写入不是“任意子类都能随便改”的授权替代品，仍应在方法中执行状态转换、校验或日志记录。

state !== 'queued') {
            throw new LogicException('任务不是 queued 状态');
        }
        $this->state = 'running';
    }
}

$job = new WorkerJob();
$job->start();
echo $job->state; // running
?>

如果只允许当前类写入，应使用 public private(set)。它更严格，而且该属性会隐式成为 final，子类不能重新声明同名属性。需要保留子类扩展点时，再选择 protected 写入。

四个边界决定这项语法能否直接迁移

尤其要注意数组属性：给数组追加元素本质上需要取得可写引用，因此外部对 public private(set) array $items 追加也会失败。应把追加动作封装在类方法中。对象属性则不同，外部不能把整个对象替换掉，但如果对象内部成员是 public，仍可能修改那个对象的成员。

从 getter/setter 迁移时的检查清单

1. 确认线上运行时至少是 PHP 8.4，并让 CI 使用同样的版本。
2. 先为属性补齐显式类型，再决定是 private(set) 还是 protected(set)。
3. 把原 setter 中的校验、状态流转和副作用搬到类方法，不要只做机械替换。
4. 检查子类重声明、引用传递、数组追加和对象内部修改测试。

这项语法适合表达“公开状态、受控变更”，不等于 readonly，也不等于深度不可变。需要一次写入后永久锁定时，仍应单独评估 readonly 语义；需要每次赋值都做归一化时，则把属性权限和 property hooks 分开设计。

相关问题

public private(set) 和 readonly 一样吗？

不一样。private(set) 允许类内部后续更新，readonly 还带有写入次数限制；两者的生命周期语义不同。

protected(set) 能让外部通过引用修改吗？

不能。取得引用也属于可能写入的操作，外部作用域仍会按 protected 的 set 权限拒绝。

非对称可见性适合没有类型的旧属性吗？

不适合直接套用。先补充明确类型并运行回归测试，否则应继续保留原有访问器方案。