PHP 7.2 将小写 object 列为保留关键字，禁止用作类名，导致旧项目中大写的 Object 类报错；根本原因在于解析机制混淆与自动加载冲突，需全局搜索、替换为语义化基类或 trait，并清理 opcache 与 IDE 缓存。
PHP 7.2 并没有“弃用 Object 作为类名”——它根本就没支持过这个类名。真正被弃用的是（且仅限于）用户自定义的类名 Object，因为 PHP 7.2 将 object（全小写）正式引入为保留类型关键词，而部分旧项目误用了大写的 Object 类，并依赖自动加载或命名空间模糊处理来绕过冲突，这类代码在 7.2+ 中会直接报错。
为什么 Object 类名会突然报错？
PHP 7.2 把 object 加入了保留词列表（类似 string、int），但注意：保留的是小写 object，不是 Object。问题出在 PHP 的类名解析机制上：
- 当文件中声明
class Object { }，且该文件未启用严格命名空间时，PHP 可能将其与内置类型提示语义混淆，尤其在使用declare(strict_types=1)的上下文中 - 更常见的是：Composer 自动加载器（如 PSR-4）遇到
Object类时，可能因大小写敏感文件系统（Linux/macOS）或 opcache 缓存残留，导致类找不到或解析冲突 - 某些框架（如早期 Laravel 辅助类、Zend Framework 1 的
Zend_Object衍生类）曾允许用户扩展Object，这些代码在 7.2+ 中无法通过语法校验
如何快速定位老项目中的 Object 类？
别只搜 class Object —— 实际问题常更隐蔽：
- 用
grep -r "class[[:space:]]\+Object" --include="*.php" .扫描全部 PHP 文件（注意空格和换行） - 检查
use语句：是否有use Object;或use Some\Namespace\Object;？这类 alias 在 7.2+ 中若指向非法类，会在解析阶段失败 - 搜索字符串
new Object和is_a($x, 'Object')—— 即使类不存在，运行时也可能触发 autoload，而 autoload 函数里若尝试class_exists('Object')会返回false，但 PHP 7.2+ 对保留词的检查发生在更早阶段 - 特别关注测试文件和 stubs 目录：很多老项目在 PHPUnit 测试中伪造
Object类用于 mock，这些必须重命名
Object 类重构的三类安全替换方案
不能简单替换成 stdClass —— 它没有构造逻辑、不兼容原有方法。应按实际用途分情况处理：
立即学习“PHP免费学习笔记（深入）”；
- 若
Object是空基类（仅用于继承）：改用AbstractEntity、BaseModel等语义化名称，确保所有子类extends引用同步更新 - 若
Object提供通用工具方法（如toArray()、__get()）：提取为 trait（如ArrayableTrait），避免类名冲突，也利于复用 - 若
Object是框架特定类（如 Zend Framework 1 的Zend_Object）：升级到对应现代替代（如Laminas\Stdlib\GenericObject），而非硬编码重命名
最容易被忽略的兼容性断点
重构完类名，不代表万事大吉。以下三点在部署后才暴露：
-
opcache.validate_timestamps=0时，已编译的 opcode 仍引用旧类名，需重启 PHP-FPM 或清空 opcache（opcache_reset()） - PHP 7.2+ 默认开启
error_reporting=E_ALL，而老项目常依赖@抑制错误，class Object声明失败是 Parse Error，无法被@捕获，必须修正源码 - 某些 IDE（如 PhpStorm）缓存了旧类索引，即使代码已改，跳转和补全仍指向
Object，需手动清理 IDE 系统缓存（File → Invalidate Caches）
