非对称可见性解决属性对外只读、对内可写的问题，避免双字段模式或空setter约定，适用于dto、api响应、配置类等场景，语法为public private(set) $prop。
非对称可见性解决什么问题
它让一个属性对外只读、对内可写，不用再靠 public $id + private $_id 这种双字段模式，也不用写空的 setter 或文档注释来“约定”不可写。真实场景里，比如 DTO、API 响应对象、配置类，你希望用户能读 $user->email，但不能改它——以前只能靠不写 setter 或加运行时判断，现在语言层直接约束。
常见写法与对应含义
语法核心是：在属性声明中用 (set) 后缀单独指定写权限，读权限由主 visibility（public/protected）决定。
-
public private(set) string $name;→ 外部可读，仅本类内部可写 -
protected protected(set) int $retryCount;→ 本类及子类可读可写，外部不可访问 -
public readonly string $uuid;→ 只读（PHP 8.4 的readonly属性，和非对称无关，别混用）
注意：写权限不能比读权限更宽松，比如 private public(set) 是非法的，会报编译错误。
典型改造场景与代码示例
把老代码中“靠约定”或“靠方法封装”的只读逻辑，平滑迁移到非对称可见性。
-
DTO 类去 setter 化：原写法有
public function setEmail(string $email): void { $this->email = $email; }，现在直接删掉，改成public private(set) string $email; -
实体 ID 自增保护：数据库主键通常只允许 ORM 内部设置，外部只读。
public private(set) int $id;替代private int $id;+public function getId(): int { return $this->id; } -
状态字段限制修改范围：如订单状态，只允许本类或子类更新：
protected protected(set) string $status = 'pending';
构造函数里初始化时，直接赋值即可：public function __construct(public private(set) string $title) { $this->title = $title; }，不会触发可见性报错。
配合静态分析工具使用
像 PHPStan 会检测 assign.propertyPrivateSet 错误：一旦在类外给 private(set) 属性赋值，就会报错。这不是警告，是明确的违规提示。
这意味着：
- 测试代码里不能直接
$obj->prop = 'new'，得走合法路径（如构造函数、内部方法） - 数据填充器（如 Symfony PropertyInfo）需升级支持，否则可能跳过这类属性
- IDE 能据此提供更准的自动补全和类型推导
不复杂但容易忽略：只要用了 private(set)，所有外部赋值点都得检查一遍，包括工厂、映射器、单元测试 setup。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
