PHP 8.3 新特性与兼容性风险：json_validate、Typed Class Constants 与 Random 扩展可验证指南

本文面向准备升级到 PHP 8.3 的团队，强调“可验证”的升级评估：先识别特性与变更，再以最小用例逐项验证，最终将风险收敛到发布流程中。

## 版本与环境校验

php -v
php -r "echo function_exists('json_validate') ? 'has json_validate' : 'no json_validate';"

输出中应显示 `PHP 8.3.x`，并存在 `json_validate` 列示；如不存在，确认 CLI 与 FPM 的实际版本一致。

## json_validate（8.3 新增）

用途：在不解码的情况下校验 JSON 格式正确性，避免大对象解码的内存与时间开销。

<?php
// 可验证：非法 JSON 返回 false，合法返回 true
var_dump(json_validate('{"a":1}'));       // true
var_dump(json_validate('{"a":1'));        // false
var_dump(json_validate('null'));            // true
?>

落地建议：在接收大 JSON（如消息队列/接口）时先用 `json_validate` 做“快速失败”，再按需解码。

## Typed Class Constants（8.3 新增）

用途：为类常量声明类型，提高静态约束与工具链可分析性。

<?php
class C {
    public const int MAX = 100;
}

// 可验证：类型不匹配会在解析阶段报错
// class D { public const int BAD = "100"; } // Fatal: Type mismatch
?>

落地建议：在领域常量（枚举值范围、阈值）上使用类型声明，配合静态分析（PHPStan/Psalm）提升质量门槛。

## #[\Override]（8.3 新增）

用途：显式声明某方法应覆盖父类/接口方法，编译期校验覆盖关系，防止签名漂移或拼写错误。

<?php
interface Repo { public function save(string $id): void; }
class UserRepo implements Repo {
    #[\Override]
    public function save(string $id): void {}
}

// 可验证：若父类签名更改或方法不存在，将抛出错误
?>

落地建议：对关键接口实现统一加 `#[\Override]`，把签名变更的风险提前到开发阶段暴露。

## Random 扩展（8.2 引入 Randomizer，8.3 持续完善）

用途：提供可替换的随机引擎与更一致的 API，适用于安全与模拟场景。

<?php
use Random\Randomizer;
use Random\Engine\Secure;

$r = new Randomizer(new Secure());
echo $r->getInt(1, 10), "\n";
$bytes = $r->getBytes(16);
?>

验证点：

• 在 8.3 环境确认 `Random\Randomizer` 与 `Random\Engine\Secure` 可用；如使用可复现模拟，切换到 `Random\Engine\Xoshiro256StarStar` 并固定种子。
• 评估老代码中 `mt_rand/rand` 的使用，必要时迁移到 `Randomizer` 获得更一致的语义。

## 升级兼容性检查清单（可验证）

• 扩展一致性：确认 CLI/FPM/Worker 的 `php -v` 与已加载扩展一致。
• 静态分析：开启 PHPStan/Psalm 并开启 Typed Class Constants 的规则，检查不匹配处。
• 属性覆盖：为接口/父类实现补充 `#[\Override]`，一次性暴露签名漂移。
• JSON 输入：在解码前统一加 `json_validate` 保护（记录错误样例与来源）。

## 回归与监控建议

• 压测关键接口 60–120 秒，记录 `RPS` 与 `p95/p99` 变化（防止意外性能回退）。
• 记录 JSON 入口校验命中率与错误分布，评估 `json_validate` 的收益。
• 在日志中采集覆盖错误（`#[\Override]`）与类型错误（Typed 常量）出现频率，作为质量门禁指标。

## 注意事项

• 生产升级前，用容器/沙箱构建与线上一致的构建链路（Composer 与扩展版本）进行预演。
• 检查框架与依赖的 PHP 版本约束（`composer.json` 的 `platform.php` 与 `require.php`）。
• 避免在单次发布中同时升级 PHP 与多项基础设施（Redis/MySQL 扩展），降低关联风险。

## 结语

PHP 8.3 带来的 `json_validate`、Typed Class Constants 与 `#[\Override]` 能把“运行时意外”前移到“编译期/解码前”暴露。用可验证的最小用例把升级风险压缩到发布前，是稳定演进的关键路径。