🚀 PHP 8.4 属性钩子 + 异步信号处理，CLI 服务真的起飞了

PHP 8.4 正式版已于 2024 年 11 月 21 日发布，这一版最值得专业开发者关注的，是 属性钩子（Property Hooks）​ 与 异步信号处理​ 在工程实践中终于可以写出”不那么脏”的代码。一个管对象内部状态的读写收敛，一个管 CLI 常驻进程的生死响应，配合起来正好是现代化 PHP 守护服务的刚需。

🎯 属性钩子：告别满屏的 getter/setter

PHP 8.4 为非静态属性引入了 get 和 set 两个钩子，允许在声明属性的同时直接拦截读/写行为。IDE 和静态分析工具原生可读，不再依赖容易过期的 docblock。

class User {
    public string $email {
        get => $this->email;
        set(string $value) {
            if (!filter_var($value, FILTER_VALIDATE_EMAIL)) {
                throw new InvalidArgumentException('邮箱格式非法');
            }
            $this->email = strtolower($value);
        }
    }

    public string $fullName {
        get => trim("{$this->first} {$this->last}");
    }
}

几个必须记住的边界：

• 钩子属性分为 backed（有底层存储）和 virtual（纯计算，不占内存）两类

• get 支持箭头函数简写：get => 表达式

• set 的参数类型必须与属性类型协变兼容

• ⚠️ 属性钩子与 readonly 不兼容，需要限制写入请用 非对称可见性（public private(set)）

在 DDD 领域对象、DTO、配置类中，属性钩子可以把校验、规范化、派生属性直接内聚到属性声明上，减少大量样板方法。

⚡ 异步信号处理：CLI 常驻服务的优雅之道

PHP 的 PCNTL 扩展提供 Unix 风格的信号处理，官方明确：不应在 Web 服务器环境中启用，否则结果不可预期。也就是说，异步信号这套机制只属于 CLI SAPI。

PHP 7.1+ 可用 pcntl_async_signals(true) 开启异步信号投递，信号可在任意执行点中断当前流程进入回调。

pcntl_async_signals(true);

pcntl_signal(SIGTERM, function () {
    // 设置退出标志，由主循环优雅收尾
    $GLOBALS['running'] = false;
});

pcntl_signal(SIGUSR1, function () {
    // 热重载配置
    reloadConfig();
});

while ($GLOBALS['running'] ?? true) {
    pcntl_signal_dispatch(); // 关键：必须手动分发
    doWork();
    usleep(10000);
}

生产环境踩坑要点：

1. FPM/Web SAPI 下 pcntl_async_signals() 会直接报错：async signals can only be used in CLI mode

2. 必须周期调用 pcntl_signal_dispatch()，否则回调永不执行

3. 回调里只能做异步信号安全操作——禁止 echo、file_put_contents、PDO 查询等，否则可能 segfault；正确做法是”回调只设标志位，主循环处理业务”

4. pcntl_wait() 等阻塞调用不会主动触发信号分发，需要时把 pcntl_signal 第三参数设为 false 强制中断

5. pcntl_fork() 后子进程必须重新注册信号，否则继承的 handler 引用可能失效

🔧 两者结合的真实场景

在 CLI 常驻服务（消费队列、WebSocket Server、定时任务调度器）中，属性钩子负责业务对象的状态一致性，异步信号负责进程生命周期管理，分工清晰：

💡 用属性钩子保证 User、Order、Config 等领域对象的属性写入即校验；用 SIGTERM 优雅退出、SIGUSR1 热重载、SIGUSR2 触发垃圾回收——这就是 PHP 8.4 现代化守护服务的标准骨架。

📌 升级前必读

• 属性钩子是 PHP 8.4+ 语法，8.3 及以下会 Parse Error

• 现有 __get/__set 魔法方法与属性钩子语义不同，迁移时需逐属性评估

• 信号处理代码必须运行在 CLI 单进程上下文中，php-fpm worker 中注册信号是典型的反模式

• 当前 PHP 8.4 最新稳定版已迭代至 8.4.20，生产环境建议直接使用最新补丁版本

属性钩子解决的是”对象内部状态怎么管”，异步信号处理解决的是”进程在操作系统里怎么活”——这两个特性一个向内、一个向外，正好构成 PHP 8.4 在后端服务化方向上的关键拼图。