PHP 8.4 新特性全解析：Property Hooks、Asymmetric Visibility 实战指南

PHP 8.4 正式发布：一个里程碑版本

PHP 8.4 于 2024 年 11 月 21 日正式发布，这是 PHP 8.x 系列中功能最丰富的版本之一。从 Property Hooks 到 Asymmetric Visibility，从新的数组函数到 HTML5 解析器，PHP 8.4 在语言表达力、开发效率和现代化程度上都迈出了重要一步。

本文将深入解析 PHP 8.4 中最值得关注的新特性，结合实际代码示例帮助你快速上手，并了解这些改变对日常开发的实际影响。

Property Hooks：优雅的属性访问控制

Property Hooks 是 PHP 8.4 中最受期待的特性之一，它允许开发者直接在属性声明处定义 get 和 set 的逻辑，无需再编写大量 getter/setter 方法。

<?php

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

    public string $email {
        get => $this->email;
        set {
            if (!filter_var($value, FILTER_VALIDATE_EMAIL)) {
                throw new \InvalidArgumentException("Invalid email: $value");
            }
            $this->email = strtolower($value);
        }
    }

    public function __construct(
        public string $firstName,
        public string $lastName,
        string $email
    ) {
        $this->email = $email; // 触发 set hook
    }
}

$user = new User('John', 'Doe', 'JOHN@EXAMPLE.COM');
echo $user->fullName;  // John Doe
echo $user->email;     // john@example.com

Property Hooks 的优势在于：

• 减少样板代码，类定义更简洁

• 属性访问语法保持不变，对外部调用透明

• 支持接口中声明带 Hook 的属性

• 可与构造器属性提升（Constructor Promotion）结合使用

Asymmetric Visibility：读写权限分离

Asymmetric Visibility（非对称可见性）允许为属性的读（get）和写（set）单独设置访问权限。这在构建只读 DTO、领域模型时非常有用。

<?php

class Order {
    // public 可读，private 可写（只能在类内部修改）
    public private(set) int $status = 0;

    // public 可读，protected 可写（类及子类内部可修改）
    public protected(set) string $orderId;

    public function __construct(string $orderId) {
        $this->orderId = $orderId;
    }

    public function confirm(): void {
        $this->status = 1; // 类内部可以修改
    }
}

$order = new Order('ORD-20241121-001');
echo $order->orderId;  // 可以读取
echo $order->status;   // 可以读取

// $order->status = 2;  // Fatal Error: 外部无法写入
$order->confirm();      // 通过方法修改，OK
echo $order->status;   // 1

非对称可见性与 Property Hooks 可以组合使用，为复杂业务模型提供更精细的访问控制。

新增数组与字符串函数

PHP 8.4 新增了多个实用的内置函数，大幅减少了对第三方库或手写工具函数的依赖。

array_find() 和 array_find_key()

<?php

$users = [
    ['id' => 1, 'name' => 'Alice', 'age' => 28],
    ['id' => 2, 'name' => 'Bob', 'age' => 35],
    ['id' => 3, 'name' => 'Charlie', 'age' => 22],
];

// 找到第一个年龄大于30的用户
$found = array_find($users, fn($user) => $user['age'] > 30);
// ['id' => 2, 'name' => 'Bob', 'age' => 35]

// 找到第一个满足条件的键
$key = array_find_key($users, fn($user) => $user['name'] === 'Charlie');
// 2

// array_any() - 任意元素满足条件
$hasMinor = array_any($users, fn($u) => $u['age'] < 18);
// false

// array_all() - 所有元素满足条件  
$allAdults = array_all($users, fn($u) => $u['age'] >= 18);
// true

mb_trim、mb_ltrim、mb_rtrim：多字节字符串修剪，终于不用手写正则了：

<?php

$str = "　　PHP 8.4 新特性　　";  // 包含全角空格
echo mb_trim($str);  // "PHP 8.4 新特性"

// 还支持自定义修剪字符
echo mb_trim("【PHP开发】", "【】");  // "PHP开发"

HTML5 解析器与其他改进

PHP 8.4 引入了基于 Lexbor 库的全新 HTML5 解析器，通过 Dom\HTMLDocument 类提供符合 HTML5 规范的解析能力，解决了旧 DOMDocument 无法正确处理现代 HTML5 标签的问题。

<?php

// 新的 HTML5 兼容解析器
$dom = Dom\HTMLDocument::createFromString(
    '<article><h1>标题</h1><p>内容</p></article>',
    LIBXML_NOERROR
);

$h1 = $dom->querySelector('h1');
echo $h1->textContent;  // 标题

// 支持 CSS 选择器
$paragraphs = $dom->querySelectorAll('article p');
foreach ($paragraphs as $p) {
    echo $p->textContent . PHP_EOL;
}

其他值得关注的改进：

• 链式方法调用 new 对象无需括号：$result = new MyClass()->method(); 不再需要 (new MyClass())->method()

• #[\Deprecated] 注解：可在代码中标记弃用，触发与内置弃用相同的警告

• Lazy Objects（延迟对象）：内置支持延迟初始化，无需依赖 Proxy 库

• BCMath 支持运算符重载：BcMath\Number 类支持 +、-、*、/ 等运算符

升级建议与兼容性注意事项

PHP 8.4 移除了一些已弃用的特性，升级前需重点检查：

• 隐式可空参数类型已被弃用（function foo(string $s = null) 需改为 ?string）

• E_STRICT 常量已移除

• 部分 IMAP、LDAP 函数签名有变化

• 建议使用 php8-rector 或 PHP_CodeSniffer 扫描兼容性问题

总体而言，PHP 8.4 是一次充满诚意的版本更新，Property Hooks 和 Asymmetric Visibility 尤其值得在新项目中积极采用。随着 Laravel、Symfony 等主流框架的跟进支持，PHP 8.4 将成为未来几年 PHP 生产环境的主流选择。