PHP 怎么PHP 8.4 属性钩子

本文目录导读：

1. 基本语法
2. 核心概念
3. 完整示例
4. 与现有 Getter/Setter 的对比
5. 注意事项和限制
6. 使用建议
7. 实际应用场景

PHP 8.4 引入了属性钩子（Property Hooks），这是一个期待已久的功能，允许你在不改变外部接口的情况下，为属性的读取（get）和赋值（set）操作添加自定义逻辑。

虽然 PHP 8.4 尚未最终发布（目前处于 Alpha/Feature Freeze 阶段），但这个特性已经基本定型，下面我们来详细了解它的语法和用法。

基本语法

属性钩子允许你在类的属性声明中直接定义 get 和 set 方法。

<?php
class User
{
    // 传统写法：需要手动创建私有属性和 getter/setter 方法
    // private string $name;
    // public function getName(): string { ... }
    // public function setName(string $value): void { ... }
    // PHP 8.4 属性钩子写法
    public string $name {
        get => $this->name;        // 读取时的逻辑
        set(string $value) => $this->name = strtoupper($value); // 设置时的逻辑
    }
    public function __construct(string $name)
    {
        $this->name = $name; // 注意：构造函数中直接赋值会调用 set 钩子
    }
}
$user = new User('john');
echo $user->name; // 输出 "JOHN" (因为 set 触发了 strtoupper)

核心概念

1 后备字段（Backing Value）

当你使用属性钩子时,PHP 会自动在类内部创建一个后备值（backing value），这个后备值以 $this->属性名 的形式访问，但你不能在类外部直接声明它。

• 有后备值：当你定义 public string $name { get => ...; set => ...; } 时，PHP 会自动创建 $this->name 作为存储实际值的地方。
• 无后备值：如果只有 get 钩子且不使用 $this->name，则不会创建后备字段（例如计算属性）。

2 get 钩子

• 返回属性的值。
• 可以用 => 表达式方式（只读属性）或用 块。
• get 钩子通过 $this->属性名 读取后备值，会直接读取而不触发递归。

public string $fullName {
    get {
        return $this->firstName . ' ' . $this->lastName;
    }
}

3 set 钩子

• 接收一个参数（默认与属性类型相同）。
• 可以用 => 或 块。
• 参数可以指定类型（必须兼容属性类型）。

public int $age {
    set(int $value) {
        if ($value < 0) {
            throw new \InvalidArgumentException('Age must be positive');
        }
        $this->age = $value; // 写入后备值
    }
}

完整示例

<?php
class Product
{
    private float $price;
    public function __construct(
        public string $name,
        float $price,
        public float $taxRate = 0.20
    ) {
        $this->price = $price; // 调用 set 钩子
    }
    // 带验证和转换的 set 钩子
    public float $price {
        set(float $value) {
            if ($value <= 0) {
                throw new \InvalidArgumentException("Price must be positive");
            }
            $this->price = round($value, 2);
        }
        get => $this->price; // 直接读取后备值
    }
    // 计算属性（只读，无后备值）
    public float $priceWithTax {
        get => $this->price * (1 + $this->taxRate);
    }
    // 带默认值的属性
    public array $tags = [] {
        set(array $value) {
            $this->tags = array_unique($value);
        }
    }
}
$product = new Product("Laptop", 999.99);
echo $product->priceWithTax; // 输出 1199.988 (999.99 * 1.20)
$product->tags = ["electronics", "laptop", "electronics"];
print_r($product->tags); // 输出 ["electronics", "laptop"] (去重了)

与现有 Getter/Setter 的对比

注意事项和限制

1. 构造函数行为：如果在构造函数中使用 $this->name = ...，它会触发 set 钩子（如果定义了），这是为了保持一致性。

2. 继承：

   • 子类可以覆盖属性钩子,但必须保持类型兼容。
   • 父类的私有后备字段不能被直接访问。

3. 接口：接口中不能定义属性钩子，只能定义标准的方法（getter/setter 方法）。

4. 抽象属性：抽象类可以定义抽象属性钩子（需要子类实现）。

abstract class Shape {
    abstract public float $area { get; }
}
class Circle extends Shape {
    public function __construct(public float $radius) {}
    public float $area {
        get => pi() * $this->radius ** 2;
    }
}

5. 引用传递：get 钩子返回的是数组或对象，默认是按引用返回的（与普通属性行为一致），但需要注意不要意外修改。

使用建议

• 何时使用属性钩子：当你需要简单的验证、转换或延迟计算时，属性钩子非常简洁。
• 何时继续使用 Getter/Setter：当逻辑很复杂、需要多个参数、或者需要在接口中定义时，传统方法仍然合适。
• 代码风格：如果项目中同时存在两种风格，建议保持一致。

实际应用场景

// 1. 数据规范化
public string $email {
    set(string $value) => $this->email = strtolower(trim($value));
}
// 2. 只读属性（初始化后不可变）
public readonly DateTimeImmutable $createdAt {
    get => $this->createdAt ??= new DateTimeImmutable();
}
// 3. 类型转换
public int $views {
    get => (int) $this->views; // 确保总是返回 int
    set(mixed $value) => $this->views = (int) $value;
}

PHP 8.4 的属性钩子是现代 PHP 向更简洁、更表达性语言迈进的重要一步，它让属性本身就能携带简单的行为逻辑，减少了样板代码，同时保持了向后兼容性（你仍然可以使用传统的 getter/setter）。

如果你正在开发新项目或更新到 PHP 8.4，可以优先在某些场景尝试使用属性钩子，体验它带来的便利。