PHP 8.4 访问器必须显式声明私有存储属性，禁止递归调用；get/set 类型须严格匹配属性声明；不支持不对称可见性（如 public(set) 搭配 private get）；ORM 不自动识别访问器逻辑，需手动配置或改用方法映射。
PHP 8.4 Accessor 的声明必须显式指定存储位置
PHP 8.4 的 get 和 set 访问器不是“自动绑定字段”的魔法语法——它不会帮你隐式创建底层存储变量。如果你写 public string $name { get => ucfirst($this->name); }，就会无限递归调用自身 getter，最终触发 Fatal error: Maximum function nesting level reached。
正确做法是：用一个私有属性（如 $_name）作为真实存储槽，get 和 set 都操作它：
class User {
private string $_name = '';
public string $name {
get => ucfirst($this->_name);
set => $this->_name = trim($value);
}
}
-
$this->name读取时走get块，返回处理后值 -
$user->name = ' alice '写入时走set块，存入$_name并清理空格 - 不要在
get中直接读$this->name，那会再次触发get
参数类型和返回类型必须与属性声明一致
Accessor 的 set 参数类型、get 返回类型，必须严格匹配属性声明的类型。PHP 不会做隐式转换，类型不一致会报 Fatal error: Type error。
例如这个错误写法：
立即学习“PHP免费学习笔记（深入）”；
public int $age {
set(string $value) { // ❌ 声明了 int 属性，但 set 参数是 string
$this->_age = (int)$value;
}
}
应改为：
public int $age {
set(int $value) { // ✅ 类型与属性声明完全一致
$this->_age = $value < 0 ? 0 : $value;
}
get => $this->_age ?? 0;
}
- 属性是
int，set参数必须是int；是string，就不能传null（除非属性声明为string|null） -
get块的返回值也必须满足属性类型约束，不能返回float给int属性 - PHP 8.4 不支持在
set块里做运行时类型转换来绕过检查
不对称可见性要小心 set-only 保护逻辑失效
PHP 8.4 支持分离控制 get 和 set 的可见性，比如 public protected(set) string $token;。但这里有个关键限制：get 可见性不能比 set 更窄。
也就是说，以下写法是非法的：
private public(set) string $id; // ❌ 编译失败：get 是 private，set 是 public
合法写法只有这些组合：
-
public protected(set) string $status;（外部可读，仅子类可写） -
protected private(set) string $createdAt;（本类及子类可读，仅本类可写） -
private string $secret { get => $this->_secret; }（只读，无set）
如果你试图用 private(set) 搭配 public get，PHP 会直接拒绝解析，报 Parse error: syntax error，而不是运行时报错。
ORM 映射时别指望框架自动识别 Accessor 元数据
目前 Doctrine、Eloquent 等主流 ORM 在 PHP 8.4 发布初期都**不解析 get/set 块的逻辑**。它们仍依赖传统 getter/setter 方法名或注解来发现可映射属性。
这意味着：
- 你写了
public string $email { get => strtolower($this->_email); }，但 Doctrine 仍会尝试直接读写$entity->email字段，跳过你的get逻辑 - 若想让 ORM 尊重访问器行为，必须显式配置字段映射，例如在 Doctrine 中加
@ORM\CustomAccess注解（需自行实现），或改用方法映射（getEmail()） - 直接把 Accessor 属性当普通 public 字段塞进
INSERT或SELECT，会导致原始未处理值入库（比如邮箱没转小写）
真正安全的做法是：在 ORM 实体中，把带逻辑的字段全设为 private，用 Accessor 控制访问，并在 Repository 或 Mapper 层统一做格式化，不依赖 ORM 自动发现。
