PHP 8.4引入七大核心特性：一、属性钩子支持内联get/set逻辑；二、readonly类实现全对象不可变；三、不对称可见性分离读写权限；四、new后直接链式调用无需括号；五、DomHTMLDocument提供HTML5原生支持；六、BcMathNumber类支持高精度运算符重载；七、#[Deprecated]属性实现用户级废弃标注。
如果您正在使用宝塔面板管理PHP环境，并计划升级至PHP 8.4，那么您需要了解该版本引入的多项语言级革新。这些特性并非简单语法糖，而是直接重构面向对象建模能力的核心机制——尤其在DTO定义、数据封装、API响应构造等高频场景中产生实质性影响。以下是PHP 8.4新增功能的详细说明：
一、属性钩子（Property Hooks）
属性钩子允许开发者在属性声明时内联定义 get 和 set 逻辑，替代传统冗余的 getter/setter 方法，使 IDE 能原生识别访问器语义，并支持静态分析工具精确推导类型流。该机制让计算属性、赋值校验、自动类型转换等场景实现编译期约束与运行期执行的双重保障。
1、声明一个带 get 访问器的字符串属性，用于拼接字段：
public string $fullName { get => $this->firstName . ' ' . $this->lastName; }。
2、声明一个带 set 访问器的 Author 类型属性，支持自动追加到作者列表：
public Author $mainAuthor { set(Author $mainAuthor) { $this->authors[] = $mainAuthor; $this->mainAuthor = $mainAuthor; } get => $this->mainAuthor; }。
立即学习“PHP免费学习笔记（深入）”；
3、仅定义 get 钩子的属性将表现为虚拟属性，不可赋值，尝试写入会触发致命错误 Fatal error。
4、钩子内部禁止访问未初始化的依赖属性，否则将触发 Notice 并中断执行。
二、readonly 类（Readonly Classes）
readonly 类是 PHP 8.4 引入的全新语言原语，用于声明整类实例化后所有属性（含动态添加属性）均不可变。它不同于 PHP 8.3 中仅作用于单个属性的 readonly 修饰符，提供的是对象状态层面的强一致性保证，适用于配置类、API 响应 DTO、领域事件等纯数据载体场景。
1、使用 readonly class 声明一个配置类：
readonly class Config { public string $host; public int $port; }。
2、实例化后任何属性修改操作（包括反射或 __set__）均抛出 Error 而非 Exception，无法被 try/catch 捕获。
3、readonly 类禁止定义普通构造函数，必须使用构造函数属性提升语法，例如：public function __construct(public string $host, public int $port) {}。
4、类中不可定义普通方法，仅允许构造函数与只读属性声明，任何非构造函数方法定义将导致编译失败。
三、不对称可见性（Asymmetric Visibility）
不对称可见性解耦属性的读写权限控制，允许为同一属性指定不同的访问级别，例如对外只读、对内可写，从而彻底消除过去“public $id; private $_id;”这类冗余双字段模式。该特性显著简化了封装逻辑，同时增强接口契约的表达力。
1、声明一个 public 可读、private 可写的字符串属性：
public string $name { get; private set; }。
2、在类内部可通过 $this->name = 'new value'; 直接赋值，无需额外 setter 方法。
3、类外部调用 $obj->name = 'bad'; 将触发 Fatal error: Cannot assign to property。
4、支持组合修饰符，如 protected string $cache { get; private set; }，但不允许 public get + public set 的冗余写法。
四、无需括号的新实例链式调用
该特性允许在 new 表达式后直接链式调用方法，无需额外包裹括号，消除语法噪声，提升代码流畅度。其底层机制确保对象实例化与方法调用在单个表达式中完成，语义清晰且无性能损耗。
1、传统写法需显式括号：
$name = (new ReflectionClass($object))->getShortName();。
2、PHP 8.4 可直接写作：
$name = new ReflectionClass($object)->getShortName();。
3、支持多层链式调用：
$result = new HttpClient()->withHeader('User-Agent', 'PHP8.4')->get('https://api.example.com')->json();。
4、若链中任一方法返回 null，后续调用将触发 TypeError，需确保中间方法返回对象实例。
五、DOM HTML5 支持与新 DomHTMLDocument 类
PHP 8.4 为 ext-dom 扩展引入原生 HTML5 兼容能力，修复长期存在的 、
1、使用 DomHTMLDocument::createFromString 创建 HTML5 文档：
$doc = DomHTMLDocument::createFromString($htmlString);。
2、通过 querySelectorAll 使用 CSS 选择器提取元素：
$buttons = $doc->querySelectorAll('button[type="submit"]');。
3、DomHTMLDocument 不兼容 XML 模式，不可调用 loadXML()。
4、创建时若输入非 HTML5 格式内容，将静默降级为 DOMDocument 行为，不抛出异常。
六、BCMath 面向对象接口与 BcMathNumber 类
PHP 8.4 为 BCMath 扩展引入 BcMathNumber 类，支持任意精度数字的面向对象操作及标准数学运算符重载（+、-、*、/、**、%），使高精度计算代码具备自然表达力与类型安全。
1、实例化一个高精度数值：
$a = new BcMathNumber('12345678901234567890.123456789');。
2、直接使用算术运算符：
$sum = $a + new BcMathNumber('0.987654321');。
3、调用专有方法执行幂运算：
$power = $a->bcpow('2');。
4、BcMathNumber 实例不可与 float 或 int 混合运算，否则触发 TypeError。
七、#[Deprecated] 属性与用户级废弃标注
PHP 8.4 新增 #[Deprecated] 属性，允许开发者对自定义函数、方法、类常量进行废弃声明，并附带可选的替代建议与生效版本信息。该机制与内置废弃警告对齐，可被 IDE、静态分析器及 phpstan 等工具识别并提示。
1、标注一个即将废弃的方法：
#[Deprecated(replacement: 'self::newCalculate()', since: '8.4.0')] public function calculate() { ... }。
2、标注一个类常量：
#[Deprecated(since: '8.4.0')] public const LEGACY_MODE = 1;。
3、运行时调用被 #[Deprecated] 标注的元素，将触发 E_DEPRECATED 级别警告。
4、该属性不可用于类、属性或 trait，否则解析阶段报错 ParseError。
