PHP 8.3 新特性实战：Typed Constants、readonly 改进与迁移指南

为什么要升级到 PHP 8.3？

PHP 8.3 于 2023 年 11 月正式发布，支持周期到 2027 年底。相比 8.2，它带来的不只是性能微调——多项语法特性直接影响日常编码质量。如果你还在犹豫是否升级，看完本文的实战案例，相信你会迫不及待地打开终端。

本文聚焦以下几个最值得关注的特性：

• 类型化类常量（Typed Class Constants）

• readonly 属性在匿名类中的改进

• 新增 json_validate() 函数

• 动态类常量获取语法

• 新的 Randomizer 扩展 API

类型化类常量：终于可以给常量加类型了

PHP 8.2 及以前，类常量没有类型声明，任何类型都能赋值，子类覆写时也不会有类型检查。PHP 8.3 引入了类型化常量，解决了这个长期痛点。

旧写法（PHP 8.2）：

<?php
class Status {
    const ACTIVE = 1;       // 没有类型，子类可以随意覆写
    const NAME   = 'active';
}

class ExtendedStatus extends Status {
    const ACTIVE = 'yes';   // PHP 8.2 不会报错，但语义混乱！
}

新写法（PHP 8.3）：

<?php
class Status {
    const int    ACTIVE = 1;
    const string NAME   = 'active';
    const float  RATIO  = 0.95;
    const bool   IS_ENABLED = true;
}

// 子类覆写类型不匹配，直接报 Fatal Error
class ExtendedStatus extends Status {
    const int ACTIVE = 'yes';  // Fatal: Cannot use string as value for constant of type int
}

实战建议：

• 在 DTO、枚举类、配置类中优先使用类型化常量，可以在 CI 阶段就发现类型错误

• 支持的类型包括：int、float、string、bool、array、null，以及联合类型 int|string

• 接口（interface）中的常量同样支持类型声明，实现类必须遵守类型约束

<?php
interface HasVersion {
    const string VERSION = '1.0.0';
}

class App implements HasVersion {
    const string VERSION = '2.0.0'; // OK
    // const int VERSION = 2;       // Fatal Error
}

json_validate()：再也不用 json_decode 试错了

过去验证一个字符串是否是合法 JSON，我们通常这样做：

<?php
// 旧方案：解码再检查
function isValidJson(string $json): bool {
    json_decode($json);
    return json_last_error() === JSON_ERROR_NONE;
}

这个方案有个显著缺点：json_decode 会构建完整的 PHP 数据结构，对于只需要验证合法性的场景，白白消耗了内存和 CPU。

PHP 8.3 新增了 json_validate()，只做语法检查，不构建数据结构：

<?php
// 新方案：只验证，不解析
$payload = '{"user": "alice", "age": 30}';

if (json_validate($payload)) {
    $data = json_decode($payload, true);
    // 处理数据...
} else {
    throw new InvalidArgumentException('Invalid JSON payload');
}

// 也支持深度限制，防止嵌套过深的恶意输入
json_validate($payload, depth: 5);     // 最大嵌套 5 层
json_validate($payload, flags: JSON_INVALID_UTF8_IGNORE); // 忽略无效 UTF-8

踩坑记录： json_validate() 在验证失败时不会设置 json_last_error()，也没有返回错误信息。如果你需要知道具体错误，还是得用 json_decode + json_last_error_msg()。

动态类常量获取：告别硬编码的常量名

PHP 8.3 之前，访问类常量必须用字面量名称，无法使用变量：

<?php
class Color {
    const RED   = '#FF0000';
    const GREEN = '#00FF00';
    const BLUE  = '#0000FF';
}

// PHP 8.2：不能用变量访问常量
$name = 'RED';
// echo Color::$name;  // 这是访问静态属性，不是常量！
constant('Color::' . $name); // 只能用 constant() 函数，略显丑陋

// PHP 8.3：支持动态常量名
echo Color::{$name}; // 输出 #FF0000

真实使用场景——根据配置动态读取常量：

<?php
class HttpStatus {
    const int OK        = 200;
    const int NOT_FOUND = 404;
    const int ERROR     = 500;
}

function getStatusCode(string $statusName): int {
    return HttpStatus::{$statusName};
}

echo getStatusCode('OK');        // 200
echo getStatusCode('NOT_FOUND'); // 404

注意： 如果常量不存在，会抛出 Error，使用前建议加 defined() 检查或 try-catch。

从 PHP 8.2 迁移的注意事项与升级步骤

实际项目升级到 PHP 8.3，按以下步骤操作可以大幅降低风险：

第一步：本地安装 PHP 8.3 并跑测试

# Ubuntu/Debian
sudo add-apt-repository ppa:ondrej/php
sudo apt install php8.3 php8.3-cli php8.3-fpm php8.3-mbstring php8.3-xml php8.3-curl

# macOS (Homebrew)
brew install php@8.3
brew link php@8.3 --force

# 验证版本
php -v

第二步：检查废弃特性

# 用 PHP_CodeSniffer 扫描弃用特性
composer require --dev squizlabs/php_codesniffer
./vendor/bin/phpcs --standard=PHPCompatibility --runtime-set testVersion 8.3 src/

第三步：关注几个常见 Breaking Changes

• ReflectionProperty::setValue() 的参数已更新，第一个参数不再是可选的

• 静态变量在 trait 方法中的处理方式有所调整，多个类使用同一 trait 时每个类维护独立的静态变量

• 部分内置函数（如 str_pad）对类型参数更严格，确保传入正确类型

第四步：Composer 依赖更新

# 检查依赖是否支持 PHP 8.3
composer why-not php 8.3

# 更新全部依赖
composer update --with-all-dependencies

按照这四步走，大多数 Laravel/Symfony 项目都能在半天内完成升级，升级后你立刻就能享受 PHP 8.3 带来的约 5~10% 的性能提升和更严格的类型安全。