PHP-Token-Reflection因依赖废弃的token_get_all()和旧反射逻辑，无法解析PHP 7.4+新语法（如enum、readonly、mixed），官方自2016年停更，推荐改用原生Reflection API与nikic/php-parser组合替代。
PHP-Token-Reflection 已停止维护，Composer 安装后无法在 PHP 7.4+ 正常工作，不建议用于新项目。
为什么 php-token-reflection 在现代 PHP 中基本不可用
这个库依赖已废弃的 token_get_all() 行为与旧版反射 API 模拟逻辑，在 PHP 7.4 引入类型声明强化、PHP 8.0 移除动态属性警告、8.1 加入枚举和只读属性后，其解析器会频繁抛出 ParseError 或返回不完整 ReflectionClass 实例。实际测试中，哪怕解析一个含 enum Status 的简单文件，也会触发 Unexpected token T_ENUM 错误。
- 官方 GitHub 仓库自 2016 年起无更新，
composer.json最高声明支持到php: ~5.3 || ~5.4 || ~5.5 - Packagist 上最新版本
1.4.1未适配 PHP 7.3+ 的 AST 变更 - 它绕过 Zend 引擎原生反射，靠手动 tokenize 构建结构，无法识别
readonly、mixed、never等新类型
替代方案：用原生 Reflection + php-parser
真正需要“强大代码反射”的场景（如静态分析、IDE 插件、文档生成），应组合使用 PHP 官方反射 API 和 nikic/php-parser。前者处理运行时类结构，后者安全解析源码并提取语法树。
-
ReflectionClass、ReflectionFunction能准确获取已加载类的方法签名、注解、继承关系 -
nikic/php-parser的PhpParser\Parser可解析 PHP 8.2 语法，返回完整Stmt节点树，包括Stmt\Enum、Stmt\Trait等 - 两者分工明确：反射查“已加载”，parser 查“源码结构”，不互相覆盖也不遗漏
示例：获取一个未加载类的参数类型（原 PHP_TokenReflection 常用需求）：
立即学习“PHP免费学习笔记（深入）”；
$parser = (new PhpParser\ParserFactory)->create(PhpParser\ParserFactory::PREFER_PHP7);
$stmts = $parser->parse(file_get_contents('UserService.php'));
foreach ($stmts as $node) {
if ($node instanceof PhpParser\Node\Stmt\Class_) {
foreach ($node->getMethods() as $method) {
foreach ($method->getParams() as $param) {
echo $param->type; // 直接拿到 <code>Identifier</code> 或 <code>Name\FullyQualified</code> 节点
}
}
}
}
如果必须兼容旧项目，安装时的关键绕过点
仅限维护遗留系统且确认目标代码不含 PHP 7.4+ 特性时，才考虑安装。需严格锁定环境与依赖版本。
- 执行
composer require --dev jakub-onderka/php-token-reflection:1.4.1，不能省略版本号 - 在
composer.json中添加"config": {"platform": {"php": "7.3.33"}}防止 Composer 自动选错依赖 - 禁用
opcache.enable=0，该库在 OPCache 开启时可能因字节码优化跳过某些 token - 调用前必须
require_once 'vendor/autoload.php'，它不遵循 PSR-4，类名与文件路径不匹配
真正棘手的是跨版本兼容——不是“装不上”，而是“装上了但解析结果错漏”。比如把 function foo(): self 误判为返回 NULL，或把 public readonly string $id 当作普通属性忽略 readonly 标识。这类问题不会报错，只会静默失效。
