PHP 8.3 新特性实战：只读类、类型常量与 json_validate 深度解析

一、PHP 8.3 新特性概览

PHP 8.3 于 2023 年 11 月正式发布，延续了 PHP 8.x 系列的快速演进势头。相比 8.2，本次更新更加聚焦于类型安全、代码可读性和运行时性能。以下是本次更新中最值得关注的几项特性：

• 只读类（Readonly Classes）：一次声明，全局不可变
• 类常量类型声明：支持为常量指定类型约束
• json_validate() 函数：无需解码即可校验 JSON 合法性
• 新增 #[\Override] 属性：防止子类方法命名错误
• 深克隆与 readonly 属性：通过 clone 重置只读属性

二、只读类（Readonly Classes）深度解析

PHP 8.2 引入了只读属性（readonly property），PHP 8.3 进一步完善了只读类的能力，允许开发者在 clone 表达式中修改只读属性，实现"写时复制"模式。

下面是一个典型的值对象（Value Object）示例：

<?php

readonly class Money {
    public function __construct(
        public int $amount,
        public string $currency
    ) {}

    // PHP 8.3：clone 时可修改 readonly 属性
    public function withAmount(int $newAmount): static {
        return clone($this, amount: $newAmount);
    }

    public function add(Money $other): static {
        if ($this->currency !== $other->currency) {
            throw new \InvalidArgumentException('Currency mismatch');
        }
        return $this->withAmount($this->amount + $other->amount);
    }
}

$price = new Money(1000, 'CNY');
$tax   = new Money(80,   'CNY');
$total = $price->add($tax);

echo $total->amount;   // 1080
echo $total->currency; // CNY

只读类天然是线程安全的，非常适合用于 DTO、配置对象和领域值对象等场景，彻底告别"防御性克隆"的样板代码。

三、类常量类型声明

在 PHP 8.3 之前，类常量没有类型约束，运行时赋值错误只能靠人工 review 发现。PHP 8.3 允许为常量指定类型：

<?php

interface HasVersion {
    const string VERSION;
}

class App implements HasVersion {
    const string VERSION = '1.0.0';
    const int    MAX_RETRY = 3;
    const array  SUPPORTED_LOCALES = ['zh_CN', 'en_US', 'ja_JP'];
}

// 以下代码在 PHP 8.3 中会报错（类型不匹配）
class BadApp implements HasVersion {
    const string VERSION = 123; // Fatal error: Cannot use int as string constant
}

类型声明支持所有标量类型（int、float、string、bool）、array、null 以及枚举类型，大幅提升了接口契约的可靠性。

四、json_validate() 与 #[\Override] 属性

json_validate() 是一个简单却实用的新函数。在此之前，验证 JSON 字符串合法性需要完整执行 json_decode() 并检查 json_last_error()，浪费了反序列化的开销。

<?php

$raw = '{"name":"Alice","age":30}';

// 旧方式：解码再判断
json_decode($raw);
$valid_old = (json_last_error() === JSON_ERROR_NONE);

// PHP 8.3 新方式：仅校验不解码
$valid_new = json_validate($raw);

// 性能对比（大 JSON 场景）
$bigJson = json_encode(range(1, 10000));
$start = microtime(true);
for ($i = 0; $i < 1000; $i++) json_validate($bigJson);
echo 'json_validate: ' . round((microtime(true) - $start) * 1000, 2) . 'ms';
// 约为 json_decode 方式的 1/3 耗时

#[\Override] 属性用于标记子类方法意图覆盖父类方法，如果父类中不存在该方法，PHP 将抛出编译错误，有效防止因拼写错误导致的隐藏 Bug：

<?php

class Base {
    public function process(): void { /* ... */ }
}

class Child extends Base {
    #[\Override]
    public function process(): void { /* 正确覆盖 */ }

    #[\Override]
    public function procsss(): void { /* Fatal: procsss() 在父类中不存在 */ }
}

五、升级建议与最佳实践

在将现有项目升级到 PHP 8.3 之前，建议按以下步骤操作：

• 运行 php-deprecation-detector：扫描代码中的废弃特性调用
• 更新 Composer 依赖：确保所有第三方包声明了对 PHP 8.3 的兼容
• 开启 strict_types：declare(strict_types=1); 与新类型特性配合效果最佳
• 逐步迁移 DTO 为 readonly class：从新增代码开始，不必一次重构全部
• CI 中加入 PHP Stan / Psalm：静态分析工具对 8.3 新特性有完整支持

PHP 8.3 是一个稳健的生产就绪版本，新特性在不引入破坏性变更的前提下显著提升了代码质量上限。无论是新项目选型还是旧项目升级，都值得优先考虑。