PHP 8.3 核心特性

简介：

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

PHP 8.3 核心特性

　　8.3官方手册参考指南（其他特性）：https://www.php.net/releases/8.3/zh.php#new-uri-extension

一、类型化类常量

　　PHP 8.3 引入的类型化类常量是对 PHP 类型系统的重要扩展，允许开发者为类、接口、trait 和枚举中的常量显式声明类型，在编译阶段强制执行类型约束，大幅提升代码的安全性、可读性和可维护性。本文将从背景、语法、规则、应用到最佳实践进行全面解析。

特性：

　　编译时类型检查：常量赋值与重写时立即验证类型，提前捕获错误

　　明确契约定义：接口常量类型强制实现类遵守，确保一致性

　　完善类型系统：与属性类型、函数参数 / 返回类型形成完整类型安全体系

　　增强 IDE 支持：提供精准类型推断，提升开发效率与代码补全质量

示例：

<?php
class AppConfig {
    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'];
}

$appConfig = new AppConfig();
print_r($appConfig::APP_NAME); // MyApp

 

二、动态获取类常量

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

语法规则与限制:

　　大括号内表达式结果必须为字符串，否则抛出TypeError

　　支持复杂表达式（只要结果是字符串）

　　与类型化类常量 (PHP8.3 新特性) 兼容

　　动态语法同样适用于枚举类型，可直接通过变量获取枚举成员

示例;

<?php
class AppConfig {
    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'];
}

$constantName = 'APP_NAME';
//  传统写法
print_r(constant(AppConfig::class . '::' . $constantName)); // MyApp
// 新语法
print_r(AppConfig::{$constantName}); // MyApp

 

三、#[\Override] 属性

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

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

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

语法示例：

<?php
class ParentClass {
    protected function foo(): void {
        echo "父类foo执行\n";
    }
}

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

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

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

 

四、只读属性深拷贝

痛点：

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

核心要点：

　　PHP 8.3 的核心改进是：只读属性可以在 __clone() 魔术方法中被修改一次（其他位置仍然禁止修改），这是实现只读属性深拷贝的关键。

　　深拷贝需要手动递归处理：clone 默认是浅拷贝，需要在 __clone() 中显式克隆引用属性。

示例：

<?php
readonly class Post
{
    public function __construct(
        public DateTime $createdAt
    ) {}

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

$post = new Post(new DateTime('2024-01-01'));
$clonedPost = clone $post;

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

最佳实践：

　　明确深拷贝的需求：并非所有只读对象都需要深拷贝。如果只读属性引用的对象本身是不可变的（如 DateTimeImmutable），浅拷贝可能就足够了。

　　保持 __clone() 简洁：只执行必要的克隆操作，避免复杂业务逻辑。

　　使用 readonly class 表达设计意图：将整个类标记为只读，明确表示该类设计为不可变值对象

　　考虑使用不可变数据类型：如 DateTimeImmutable 替代 DateTime，减少克隆需求

　　编写单元测试验证深拷贝行为：确保克隆后的对象与原对象完全独立。

 

五、新增json_validate() 函数

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

函数参数说明：

<?php
/**
 * $json    string    要验证的字符串，此函数仅适用于 UTF-8 编码的字符串
 * $depth    int    解码结构的最大嵌套深度，必须大于 0 且 ≤ 2147483647，默认值为 512
 * $flags    int    标志位掩码，目前仅支持 JSON_INVALID_UTF8_IGNORE，默认值为 0
 */
function json_validate(string $json, int $depth = 512, int $flags = 0): bool

示例：

<?php
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
declare (strict_types = 1); 

namespace app\controller;

use app\BaseController;
use Random\Randomizer;

class Index extends BaseController
{
    public function index()
    {
        $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();

        dump($strRe); // 86vfq8dxmfbkwe3l
        dump($getFloatRe); // 42.155498374675
        dump($nextFloatRe); // 0.94623594442678
    }
}