需在 composer.json 的 require 中声明 "php": "^8.1"，否则即使代码使用原生 enum，Composer 安装也不会报错，但运行时因 PHP 版本过低触发 ParseError。
Composer require 里怎么声明 PHP 8.1+ 才能用原生 enum
Composer 不会因为你写了 enum 就自动检查 PHP 版本，它只认 php 这个根级依赖项。你得手动在 composer.json 的 require 里加一条 "php": "^8.1"，否则即使代码里用了 enum，低版本 PHP 加载时直接报错，Composer 安装阶段却不会拦住你。
常见错误现象：ParseError: syntax error, unexpected token "enum" —— 这说明 Composer 成功安装了包，但运行时 PHP 解析失败，因为实际环境是 8.0 或更低。
-
"php": "^8.1"写在require下，不是require-dev（除非你确定只在 dev 环境用 enum） - 如果项目同时支持 CLI 和 Web，两个环境的 PHP 版本都得 ≥8.1；
php -v和phpinfo()得分别确认 - 别写成
"php": ">=8.1.0"—— 虽然语法合法，但^8.1更符合语义，且兼容后续 8.x 小版本
PHP 8.1 enum 在 composer.lock 里会不会被标记为“特性依赖”
不会。composer.lock 只记录已安装的包版本和哈希值，不记录语言特性使用情况。哪怕你代码里满屏 enum，lock 文件里也看不到任何相关字段。
这意味着：别人 clone 你的项目、运行 composer install，只要 composer.json 没写对 php 版本约束，就可能在旧 PHP 上静默安装成功，直到第一次加载 enum 文件才崩。
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查方式：
composer show --platform能看到当前环境声明的 PHP 版本，但它不校验代码是否真用了高版本语法 - CI/CD 中建议加一步：
php -l src/YourEnum.php（单独 lint 枚举文件），比等整个应用跑起来再报错更快暴露问题 - IDE（如 PhpStorm）能识别
enum语法，但不会帮你校验composer.json里的 PHP 版本声明是否匹配
require 中写 "php": "^8.1" 会影响哪些包的安装
它影响的是「所有包的版本选择」—— Composer 会过滤掉那些在 composer.json 的 require 或 conflict 中声明了不兼容 PHP 8.1 的包版本。
例如某库 v2.0 声明了 "php": "^7.4 || ^8.0"，而 v3.0 改成了 "php": "^8.1"，那么你写 "php": "^8.1" 后，Composer 就不会选 v2.0，哪怕它功能更熟、文档更全。
- 不是所有包都会及时更新自己的 PHP 版本约束，有些老包可能至今只标到
^7.4，即使它实际能在 8.1 下跑 —— 这时候你要么提 PR，要么 fork 后改composer.json自己维护 -
conflict字段比require更精准：比如你想明确禁止某个包的 v1.x（因它内部用ReflectionEnum但没做版本判断），可以加"conflict": {"vendor/package": "^1.0"} - 执行
composer update --dry-run能提前看到哪些包会被降级或跳过，避免上线前才发现关键依赖装不上
为什么 enum 类不能放在 autoload-dev 里“假装不用”
因为 enum 是语言结构，不是类——它没有命名空间解析延迟，PHP 解析器在首次读取文件时就要求版本达标。哪怕你把它塞进 autoload-dev、且从不 use，只要该文件被 include 或 require（比如被测试引导文件加载），就会立刻触发解析错误。
典型场景：你把 StatusEnum.php 放在 tests/ 下，又在 phpunit.xml 的 bootstrap 里 require_once 'tests/StatusEnum.php'，结果 PHPUnit 还没开始跑，PHP 就挂了。
- 不要指望自动加载机制“绕过”语法检查；
enum的解析发生在 AST 构建阶段，远早于 autoloader 触发 - 如果必须兼容低版本，唯一办法是彻底不用
enum，改用 class + const + 静态方法模拟（如 Laravel 的Enumtrait），但那就不是原生枚举了 - 某些构建工具（如 Roave Backward Compatibility Check）能扫描源码里是否含
enum关键字，可作为 CI 中的额外守门员
最常被忽略的一点：PHP-FPM 的子进程可能缓存了 opcache，导致你改了 composer.json 并重装后，旧进程仍用着未清理的 opcode，继续报错。这时候不是 Composer 没生效，而是 PHP 进程没重启。
