PHP 8.3 核心特性

简介：

自 PHP 8.0 发布以来，该语言经历了一系列重要的功能迭代与性能改进。对于开发者而言，系统理解这些新特性不仅是技术更新的需要，更是优化代码设计、降低维护成本的有效途径。本分类将按版本梳理 PHP 8.x 的新特性。

8.3 官方手册参考指南（含其他特性）：官方链接

一、类型化类常量和动态获取类常量

PHP 8.3 引入的类型化类常量是对 PHP 类型系统的重要扩展，允许开发者为类、接口、trait 和枚举中的常量显式声明类型，在编译阶段强制执行类型约束，大幅提升代码的安全性、可读性和可维护性。

特性：

编译时类型检查：常量赋值与重写时立即验证类型，提前捕获错误
明确契约定义：接口常量类型强制实现类遵守，确保一致性
完善类型系统：与属性类型、函数参数 / 返回类型形成完整类型安全体系
增强 IDE 支持：提供精准类型推断，提升开发效率与代码补全质量

PHP8.3 允许使用ClassName::{$variable}语法直接通过变量动态获取类常量，替代了 PHP8.3 之前必须使用constant()函数的繁琐方式。

语法规则与限制:

大括号内表达式结果必须为字符串，否则抛出TypeError
支持复杂表达式（只要结果是字符串）
与类型化类常量 (PHP8.3 新特性) 兼容
动态语法同样适用于枚举类型，可直接通过变量获取枚举成员示例：

php 复制代码

<?php

declare(strict_types=1);

class Example
{
    // 支持几乎所有 PHP 标准类型,不支持 void、never、callable()
    public const string APP_NAME = 'MyApp';
    public const int APP_VERSION = 100;
    public const bool DEBUG = false;
    public const array SUPPORTED_LOCALES = ['en', 'fr', 'es'];
}

echo '<pre>';
//  传统写法
var_dump(constant(Example::class . '::' . 'APP_NAME')); // MyApp
// 动态获取常量值的方式
var_dump(Example::APP_NAME); // string(5) "MyApp"
var_dump(Example::APP_VERSION); // int(100)
var_dump(Example::DEBUG); // bool(false)
var_dump(Example::SUPPORTED_LOCALES); // array(3) { [0]=> string(2) "en" [1]=> string(2) "fr" [2]=> string(2) "es" }

二、#[\Override] 属性

#[\Override] 属性是 PHP 8.3 引入的一个编译时验证工具，其设计初衷非常纯粹：让开发者能够明确表达"我打算重写/实现这个方法"的意图，并由引擎代为验证这个意图是否真实成立。这一看似简单的功能，解决的是长期潜伏在 PHP 继承体系中的一类静默错误（当父类或接口中的方法被移除、重命名或签名发生变化时 [ 滑拼错方法名、写错参数、父类改了方法名 ]，子类中原本意图重写的方法会悄然"失联"，变成普通方法继续存在，既不报错也不警告）。

语义：标记了此属性的方法，必须存在一个同名的父类方法或接口方法与之匹配，否则将触发编译时致命错误。它不是强制性的语法要求，而是一种可选的防御性编程手段，帮助开发者在编译阶段而非运行时捕获继承链中的断裂。

限制： #[\Override] 不能应用于构造函数 __construct()，因为构造函数不受签名兼容性检查规则的约束。

示例：

php 复制代码

<?php

declare(strict_types=1);

class ParentClass {
    protected function foo(): string {
        return "父类foo执行\n";
    }
}

class ChildClass extends ParentClass {
     // 正确重写父类方法，若此foo方法名称拼写异常会报错
     // 无#[\Override] 则不会报错，且callFoo执行父类foo 输出：父类foo执行
    #[\Override]
    protected function foo(): string {
        return "子类foo方法执行成功！\n";
    }

    public function callFoo():string {
        return $this->foo();
    }
}

$childClass = new ChildClass();
var_dump($childClass->callFoo()); // 子类foo方法执行成功！

四、只读属性深拷贝

痛点：

在 PHP 8.1 引入只读属性（Readonly Properties）后，开发者能够声明一旦初始化便不可修改的属性，这为构建不可变对象（Immutable Objects）提供了语言级的支持。然而，在 PHP 8.1/8.2 中，只读属性一旦初始化，就无法在任何地方被重新赋值------即使是 __clone() 魔术方法中也不行。这意味着当你克隆一个只读类的实例时，新对象的只读属性将完全复制原对象的值，无法进行任何调整。这在深拷贝场景下尤其棘手：例如，一个包含 DateTime 只读属性的对象，在克隆后你无法重置其创建时间。

核心要点：

PHP 8.3 的核心改进是：只读属性可以在 __clone() 魔术方法中被修改一次（其他位置仍然禁止修改），这是实现只读属性深拷贝的关键。
深拷贝需要手动递归处理：clone 默认是浅拷贝，需要在 __clone() 中显式克隆引用属性。

示例：

php 复制代码

<?php

declare(strict_types=1);

readonly class Example
{
    public function __construct(
        public DateTime $createdAt
    ) {}

    public function __clone(): void
    {
        // PHP 8.3 允许在这里重新初始化只读属性
        $this->createdAt = new DateTime();
    }
}

$example = new Example(new DateTime('2024-01-01'));
$cloneExample = clone $example;

// 克隆后的对象拥有新的创建时间，原对象保持不变
echo $example->createdAt->format('Y-m-d');     // 2024-01-01
echo '<br>';
echo $cloneExample->createdAt->format('Y-m-d'); // 当前日期（克隆时刻）

最佳实践：

明确深拷贝的需求：并非所有只读对象都需要深拷贝。如果只读属性引用的对象本身是不可变的（如 DateTimeImmutable），浅拷贝可能就足够了。
保持 __clone() 简洁：只执行必要的克隆操作，避免复杂业务逻辑。
使用 readonly class 表达设计意图：将整个类标记为只读，明确表示该类设计为不可变值对象
考虑使用不可变数据类型：如 DateTimeImmutable 替代 DateTime，减少克隆需求
编写单元测试验证深拷贝行为：确保克隆后的对象与原对象完全独立。

五、新增 json_validate() 函数

json_validate() 是 PHP 8.3 新增的一个内置函数，用于判断给定的字符串是否为语法上有效的 JSON。在此之前，PHP 开发者只能通过调用 json_decode() 并检查错误来判断字符串是否是有效的 JSON，这种方法虽然可行，但会不必要地消耗内存和处理资源。

语法示例：

php 复制代码

<?php

declare(strict_types=1);

/**
 * 描述: 验证一个字符串是否是有效的 JSON 格式。
 * 
 * json_validate(string $json, int $depth = 512, int $flags = 0): bool
 * 
 * $json: 要验证的字符串，此函数仅适用于 UTF-8 编码的字符串。
 * $depth: 可选参数，解码结构的最大嵌套深度，必须大于 0 且 ≤ 2147483647，默认值为 512
 * $flags: 可选参数，标志位掩码，目前仅支持 JSON_INVALID_UTF8_IGNORE，默认值为 0
 * 
 * 返回值: 如果输入字符串是有效的 JSON，则返回 true；否则返回 false。
 */
echo '<pre>';
// 注：空字符串不是有效 JSON
var_dump(json_validate('')); // false
// 注： JSON 中的 null 是有效值
var_dump(json_validate('null')); // true
var_dump(json_validate('{"framework": "Laravel"}'));  // true
var_dump(json_validate('{"framework": "Laravel}'));   // false

六、Randomizer 新增方法

PHP 8.3 为 Randomizer 类新增的 getBytesFromString(), nextFloat(), 和 getFloat() 等方法，主要是为了解决在纯 PHP 层面难以高效、无偏地实现的随机需求。它们为开发者提供了更强大、更安全的随机数据处理能力。

Randomizer::getBytesFromString()：从字符串池中按权重生成随机字符串。
Randomizer::getFloat() & nextFloat()：无偏差的随机浮点数生成。

示例：

php 复制代码

<?php

declare(strict_types=1);

use Random\Randomizer;

$randomizer = new Randomizer();
// Randomizer::getBytesFromString()：从字符串池中按权重生成随机字符串。
$strRe = $randomizer->getBytesFromString('abcdefghijklmnopqrstuvwxyz0123456789', 16);

/******** Randomizer::getFloat() & nextFloat()：无偏差的随机浮点数生成。 *************/

// getFloat($min，$max) 示例默认模式 [42, 43)，即包含42，不包含43
$getFloatRe = $randomizer->getFloat(42, 43);

// nextFloat()此方法专为生成半开区间 [0.0, 1.0) 内的随机浮点数而设计 
// 它等价于 getFloat(0.0, 1.0, IntervalBoundary::ClosedOpen)，但由于是专为 [0, 1) 范围优化的，
// 因此性能更高。此范围非常适合进行概率判断（如 nextFloat() < 0.3 表示30%的概率
$nextFloatRe = $randomizer->nextFloat();

echo '<pre>';
var_dump($strRe); // string(16) "fhfpemknxybjko2g"
var_dump($getFloatRe); // float(42.043780451698495)
var_dump($nextFloatRe); // float(0.27596100126099155)