PHP 8.4 新特性详解：属性钩子、不对称可见性与性能提升

属性钩子（Property Hooks）

PHP 8.4 最重要的特性是属性钩子，它让你无需编写冗长的 getter/setter 方法：

// PHP 8.3：需要手动写 getter/setter
class User {
    private string $name;
    
    public function getName(): string {
        return $this->name;
    }
    
    public function setName(string $name): void {
        $this->name = ucfirst(strtolower($name));
    }
}

// PHP 8.4：属性钩子一行搞定
class User {
    public string $name {
        get => $this->name;
        set => ucfirst(strtolower($value));
    }
}

$value 是 set 钩子中的内置变量，代表传入的值。

只读属性 vs 属性钩子

// readonly：初始化后不可变
class Config {
    public readonly string $apiKey;
    
    public function __construct(string $key) {
        $this->apiKey = $key;
    }
}

// 属性钩子：可以控制读写逻辑
class Config {
    private string $rawKey;
    
    public string $apiKey {
        get => base64_encode($this->rawKey);
        set => $this->rawKey = base64_decode($value);
    }
}

不对称可见性

PHP 8.4 允许属性的 set 可见性比 get 更严格：

class BankAccount {
    public private(set) float $balance = 0;
    
    public function deposit(float $amount): void {
        $this->balance += $amount;
    }
}

$account = new BankAccount();
$account->balance = 1000;  // Error：不能从外部 set
echo $account->balance;     // OK：可以从外部 get

public private(set) 表示：外部可读，但只有类内部可写。这比 PHP 8.1 的 readonly 更灵活，因为属性仍然可以被类内部修改。

新的数组函数

array_find / array_find_key

$users = [
    ['id' => 1, 'name' => 'Alice', 'active' => false],
    ['id' => 2, 'name' => 'Bob', 'active' => true],
    ['id' => 3, 'name' => 'Charlie', 'active' => true],
];

// 找到第一个满足条件的元素
$firstActive = array_find($users, fn($u) => $u['active']);
// ['id' => 2, 'name' => 'Bob', 'active' => true]

// 找到键
$key = array_find_key($users, fn($u) => $u['active']);
// 1

array_any / array_all

$hasActive = array_any($users, fn($u) => $u['active']);  // true
$allActive = array_all($users, fn($u) => $u['active']);  // false

这些函数让代码不再需要 array_filter + count 的组合：

// 旧写法
$hasActive = count(array_filter($users, fn($u) => $u['active'])) > 0;

// PHP 8.4
$hasActive = array_any($users, fn($u) => $u['active']);

性能提升

PHP 8.4 的 JIT 编译器进一步优化：

场景	PHP 8.3	PHP 8.4	提升
纯计算（ fibonacci ）	0.42s	0.31s	26%
Laravel 启动	45ms	38ms	16%
WordPress 首页	62ms	53ms	15%

属性钩子的性能开销几乎为零——编译时会被转换为传统的 getter/setter 方法调用，没有运行时反射成本。

实际应用示例

class Temperature {
    public function __construct(
        public float $celsius {
            get => round($this->celsius, 2);
            set => $value < -273.15 
                ? throw new ValueError("低于绝对零度") 
                : $value;
        }
    ) {}
    
    // 虚拟属性：只读，基于实际属性计算
    public float $fahrenheit {
        get => $this->celsius * 9 / 5 + 32;
    }
    
    public float $kelvin {
        get => $this->celsius + 273.15;
    }
}

$temp = new Temperature(25);
echo $temp->fahrenheit;  // 77
echo $temp->kelvin;      // 298.15
$temp->celsius = -300;   // ValueError: 低于绝对零度

虚拟属性（只有 get 没有 set）配合构造函数属性提升，让值对象的代码极其简洁。

总结

PHP 8.4 的属性钩子是继 PHP 8.0 联合类型、8.1 readonly、8.2 枚举之后最重要的特性。它消除了 getter/setter 的样板代码，同时保持了类型安全和封装性。不对称可见性提供了比 readonly 更精细的访问控制。建议在 Laravel 11+ 项目中直接使用 PHP 8.4。