php 8.4 新特性核心是属性钩子与不对称可见性:属性钩子支持 get/set 声明式逻辑,仅适用于非静态非 readonly 属性;不对称可见性(如 public private(set))实现读写权限分离,提升封装性与性能。

PHP 8.4 的新类型系统不是“新增一套类型”,而是对已有联合类型、只读性、访问器(Accessors)和属性钩子(Property Hooks)的**收敛与加固**。它不引入 string|null 之外的新基础类型,但让类型声明更一致、更不可绕过——尤其是当你启用 strict_types=1 且配合新语法时,类型错误会提前暴露在调用点,而不是运行时才崩。
怎么写 ?array 才不会被 IDE 报错或运行时报 TypeError
PHP 8.4 中 ?array 是合法且推荐的写法,等价于 array|null,但它有明确前提:
- 必须在 PHP 8.0+ 文件中使用;低于 8.0 会直接解析失败
- 若文件顶部没写
declare(strict_types=1);,传入"not an array"可能被静默转成数组(比如字符串变["n", "o", "t", ...]),这不是你想要的“可为空”,而是弱类型陷阱 -
?array $items = null是唯一安全组合;写成array $items = null会立即报TypeError,因为非空类型不允许默认值为null - 空数组
[]和null都合法;但0、false、"[]"全部非法,严格模式下直接中断
readonly 属性 + 类型声明,为什么子类一继承就 Fatal Error
PHP 8.4 对 readonly 属性加了继承锁:父类声明了 public readonly string $id;,子类再写同名属性(哪怕也是 readonly),就会触发 Fatal error: Cannot redeclare readonly property。
这不是 bug,是设计约束。原因很实际:
- 只读语义必须跨继承链保持一致,否则子类“重声明”可能偷偷改掉初始化逻辑
- 反射获取
ReflectionProperty::isReadOnly()的结果才可靠,否则无法判断某属性是否真不可变 - 如果你需要扩展行为,应该用方法(如
getFormattedId())或新增属性(如private readonly string $slug;),而不是覆盖
顺带提醒:readonly 属性一旦在构造函数里赋值,后续任何地方(包括子类构造函数)都不能再写,连 $this->id = ... 都会报错。
Accessors 里怎么写类型才不踩坑
PHP 8.4 的 get/set 访问器支持完整类型声明,但位置和规则容易错:
-
get块必须有返回类型,且不能省略 ——public string $name { get => ucfirst($this->value); }合法;public $name { get => ... }会报错:Missing return type -
set块的隐式参数$value可以声明类型,如set: string $value => $this->value = trim($value);;不写类型则默认接受任意值,失去类型保护 - 不能在
get或set里用$this->name直接递归访问自身(会爆栈),必须通过底层存储字段(如$this->value)或私有属性中转 - 访问器不参与 PHP 的
__get/__set魔术方法流程,所以 ORM 或序列化工具若没适配 8.4,可能跳过访问器逻辑
declare(strict_types=1) 必须每文件都写,不能靠“父文件带动”
这是最容易忽略的规范点:PHP 的 strict_types 是**文件级指令**,不会继承、不跨 include、不因 Composer 自动加载而生效。哪怕你在 index.php 写了,src/Model/User.php 里没写,那里的 int $id 参数照样允许传字符串。
所以真实项目中要:
- 所有新文件第一行(
<?php后立刻)加declare(strict_types=1);,中间不能有空行或注释 - 用 Rector 或 PHP-CS-Fixer 自动插入,避免漏写;命令示例:
vendor/bin/rector process src --set php80 --dry-run(选带 strict_types 的规则集) - CI 流程里加检查:grep -r 'declare(strict_types=1)' src/ | wc -l 应等于 src/ 下 .php 文件总数
类型系统真正起作用的地方,不在语法多炫,而在每一处调用都被校验——而这只发生在每个文件都主动声明之后。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











