php 8.4 的属性钩子（property hooks）允许在类属性中直接定义 `get` 和 `set` 逻辑，从而消除样板式的 getter/setter 方法。要精简模型代码，只需将传统属性声明替换为带有钩子的属性，并在 `set` 钩子中处理验证或转换，在 `get` 钩子中处理格式化或延迟加载，这样既保留了属性的访问语法，又实现了方法的控制逻辑。
如何声明带 get/set 钩子的属性
声明属性时，使用 `public`、`private` 等可见性修饰符后紧跟属性名，然后使用 `{}` 块定义钩子。例如，定义一个 `name` 属性，可以在 `set` 钩子中将输入值强制转换为字符串并去除首尾空格，在 `get` 钩子中返回该值。这种写法替代了传统的 `$this->name = $value;` 和 `return $this->name;` 语句。
class User {
public string $name {
get => $this->_name;
set {
if (empty($value)) {
throw new InvalidArgumentException("Name cannot be empty");
}
$this->_name = trim($value);
}
}
private string $_name;
public function __construct(string $name) {
$this->name = $name; // 触发 set 钩子
}
}
$user = new User(" John Doe ");
echo $user->name; // 输出 "John Doe"上述代码展示了 `User` 类的实现。当实例化 `User` 并传入带有空格的字符串时，`set` 钩子会自动执行 `trim()` 操作。如果传入空字符串，则抛出异常。访问 `$user->name` 时，`get` 钩子返回内部存储的 `_name` 值。这比手动编写 `setName()` 和 `getName()` 方法更简洁，且保持了属性访问的自然语法。
立即学习“PHP免费学习笔记（深入）”；
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
如何使用只读（get-only）钩子
只读钩子用于实现计算属性或不可变状态。只需在属性声明中省略 `set` 部分，仅保留 `get` 钩子。例如，在 `User` 模型中添加一个 `fullName` 属性，它由 `firstName` 和 `lastName` 组合而成，且不允许外部直接修改。这种模式常用于派生数据或快照值。
class User {
public string $firstName;
public string $lastName;
public string $fullName {
get => $this->firstName . ' ' . $this->lastName;
}
public function __construct(string $first, string $last) {
$this->firstName = $first;
$this->lastName = $last;
}
}
$user = new User("John", "Doe");
echo $user->fullName; // 输出 "John Doe"
// $user->fullName = "Jane"; // 编译错误：无法设置只读属性在 `User` 类中，`fullName` 是一个只读属性。每次访问 `$user->fullName` 时，都会动态计算 `firstName` 和 `lastName` 的连接结果。尝试赋值会引发编译错误，确保数据的完整性。这种设计特别适用于需要展示组合信息但不希望暴露内部状态的场景。
基于属性钩子的验证与默认值处理
在实际应用中，属性钩子常用于处理默认值和类型转换。例如，定义一个 `age` 属性，如果未提供则默认为 0，并在 `set` 钩子中确保值为正整数。这种逻辑可以直接嵌入属性声明，无需额外方法调用。
class Profile {
public int $age {
get => $this->_age ?? 0;
set {
if ($value < 0) {
throw new RangeException("Age must be non-negative");
}
$this->_age = (int)$value;
}
}
private ?int $_age = null;
public function __construct(?int $age = null) {
if ($age !== null) {
$this->age = $age;
}
}
}
$profile = new Profile();
echo $profile->age; // 输出 0
$profile2 = new Profile(25);
echo $profile2->age; // 输出 25上述 `Profile` 类展示了如何处理可选参数和默认值。构造函数接受可空的 `age`，如果为 `null`，则不触发 `set` 钩子，保持 `_age` 为 `null`。`get` 钩子中使用 null 合并运算符 `??` 返回默认值 0。如果显式设置年龄，`set` 钩子会验证并转换类型。这种模式简化了初始化逻辑，避免了在构造函数中重复编写验证代码。
