PHP 8.3升级后旧项目必然报错或警告，核心影响为：动态属性需声明或加#[AllowDynamicProperties]、类常量必须显式类型、#[Override]强制编译期校验、数组展开要求右侧恒为数组。
升级到 PHP 8.3 后，旧项目大概率会立即报错或发出弃用警告，不是“可能有问题”，而是“不改就跑不起来”。核心影响集中在动态属性、类常量类型、#[\Override] 校验和数组展开行为这四块。
动态属性默认触发 Deprecation Notice
PHP 8.3 开始，任何未加 #[\AllowDynamicProperties] 的类，只要运行时给对象赋值未声明的属性，就会抛出 Deprecation Notice: Creation of dynamic property ... is deprecated。
- 常见错误现象：Laravel 的
Model子类、DTO 类、测试中手动挂属性（如$this->response = ...）全都会报警 - 使用场景：老项目里大量存在的“临时挂载数据”写法（比如
$user->full_name = $user->first . ' ' . $user->last）现在必须提前在类中声明public string $full_name，否则警告 - 实操建议：
- 全局搜索
->\w+ =模式，定位所有动态赋值点 - 对明确需要灵活结构的类（如配置容器、API 响应包装器），加上
#[\AllowDynamicProperties] - 对实体类、DTO、领域模型，强制补全所有属性声明——别指望 IDE 自动补全，它可能漏掉 getter/setter 里隐式创建的字段
- 全局搜索
类常量必须显式声明类型，否则继承/实现时报 Fatal error
接口或父类里写 const VERSION = '1.0'，子类重写成 const VERSION = []，PHP 8.2 及以前静默通过；PHP 8.3 直接 Fatal error: Cannot use array as value for class constant。
- 常见错误现象：SDK 封装类、抽象基类、契约接口的常量被子类覆盖时崩溃；静态分析工具（如 PHPStan）提示“Constant type mismatch”
- 参数差异：以前靠注释或文档约定类型，现在必须写
const string VERSION = '1.0'、const int MAX_RETRY = 3，连const SUPPORTED_FORMATS = ['json']都得补array - 实操建议：
- 用
grep -r "const [A-Z]" --include="*.php" .扫出所有常量定义 - 优先补接口和抽象类里的常量类型——它们是契约源头，影响最广
- 注意枚举类常量也受约束，
enum Status: string { case ACTIVE = 'active'; }中的case值类型必须和枚举声明一致
- 用
#[\Override] 是编译期硬校验，拼错名或父类删方法直接 Fatal
加了这个属性，PHP 在类加载阶段就检查父类/接口是否存在同签名方法。不满足就报 Fatal error: ... has #[\Override] attribute, but no matching parent method exists，不会等到调用时才失败。
立即学习“PHP免费学习笔记（深入）”；
- 典型踩坑场景：PHPUnit 测试类里把
tearDown()拼成tearDowm()；Laravel Service Provider 的boot()方法被父类移除后子类没同步删掉#[\Override] - 使用场景：所有继承框架钩子方法（
setUp()、boot()、handle()）、自定义 Repository 覆盖find()等，都是高风险区 - 实操建议：
- 只在确认覆盖且父类方法稳定存在时添加，禁止“先加着防以后忘”
- CI 中启用
opcache.enable_cli=1，确保php -l或测试启动阶段就能暴露问题 - trait 中的方法不能加
#[\Override]——它只校验extends和implements链，加了也无效
数组展开保留字符串键，但旧的 array_merge() 逻辑可能被误删
以前写 $config = ['host' => 'localhost'] + $db; 或 array_merge(['host' => 'localhost'], $db) 是为了保留键名；PHP 8.3 支持 ['host' => 'localhost', ...$db]，但很多人升级后直接删掉 array_merge() 调用，却忘了 ... 展开要求 $db 必须是数组，而旧代码里它可能是 null 或对象。
- 常见错误现象：
TypeError: Argument #2 ($array) must be of type array, null given，因为...$db不做空值兜底 - 性能影响：
[...$a, ...$b]比array_merge($a, $b)略快，但差异微乎其微；重点在语义清晰，不是性能 - 实操建议：
- 替换前先确认右侧变量是否恒为数组，否则加
?? []，如[...($db ?? [])] - 不要全局替换
array_merge——它仍支持非数组参数（如array_merge(['a'], 'not array')会警告但不崩溃），而展开语法更严格 - 关联数组合并场景（如配置覆盖）优先用新语法，索引数组追加仍可用
array_merge或array_values([...$a, ...$b])
- 替换前先确认右侧变量是否恒为数组，否则加
最易被忽略的是：这些变更不是“可选增强”，而是 PHP 引擎在加载类或执行字节码时就介入的硬限制。一个 #[\Override] 拼错，整个类文件加载失败；一个动态属性警告，日志刷屏且可能被 error_reporting 设置为 E_ALL 时转成异常。别指望“先上线再修”，得在本地 CLI 环境跑通 php -l 和最小测试集再说。
