Symfony 7.4 要求 PHP ≥ 8.2，不支持 PHP 8.1 或更低版本，因核心组件使用了 PHP 8.2 特性（如 readonly 属性、严格类型推导），降级将触发 ParseError 或 TypeError。
FrameworkBundle、DependencyInjection）已使用 PHP 8.2 引入的语法和类型特性（例如只读类属性初始化、array_key_first() 的严格返回类型推导等），降级运行会触发 Fatal error: Uncaught TypeError。
composer require symfony/symfony:^7.4 失败的典型报错
执行命令后常见错误是：Your requirements could not be resolved to an installable set of packages.，深层原因是 Composer 检测到当前 PHP 版本（如 8.1.28）不满足 symfony/symfony 的 php: ^8.2 约束。
- 检查方式：
php -v必须输出PHP 8.2.x或8.3.x（8.3 兼容） - 不要尝试用
--ignore-platform-req=php强行绕过——即使安装成功，运行时大概率在cache:warmup或首次请求时崩溃 - 特别注意 Docker 环境：基础镜像如
php:8.1-apache必须切换为php:8.2-apache或更高
PHP 8.2 是最低要求，但推荐用 8.2.10+ 或 8.3.x
Symfony 7.4 在 PHP 8.2.0 初始版本中存在若干边缘兼容问题，比如 DebugClassLoader 对某些 trait 属性反射行为的处理异常；官方补丁集中在 8.2.10 后。
- PHP 8.2.10+：修复了
match表达式与联合类型在泛型上下文中的解析缺陷，影响OptionsResolver组件 - PHP 8.3.x：完全支持，且能启用 Symfony 7.4 的虚拟线程实验特性（需配合
ext-fiber和opcache.jit=1255） - PHP 8.4 尚未发布正式版，目前不被 Symfony 7.4 声明支持
升级 PHP 时必须同步检查扩展兼容性
PHP 8.2 废弃了 mysql_*() 函数（早该不用了），更关键的是部分扩展行为变更直接影响 Symfony 运行：
-
ext-intl：必须启用，否则IntlDateFormatter初始化失败，导致FormType中日期字段报Class "IntlDateFormatter" not found -
ext-xml：必需，XmlFileLoader已移除，但配置缓存生成仍依赖 DOMDocument -
ext-zip：必需，cache:clear命令内部用ZipArchive压缩预加载文件 - 禁用
assert.exception=0：PHP 8.2 默认开启断言异常，若设为 0，CacheWarmer可能静默跳过关键步骤
为什么不能“凑合”跑在 PHP 8.1？
这不是版本号面子问题，而是底层语义断裂。例如 Symfony 7.4 的 ContainerBuilder::getCompilerPassConfig() 返回类型声明为 CompilerPassConfig&readonly，PHP 8.1 不识别 readonly 类型修饰符，解析 AST 阶段就报 ParseError；又如 Attribute 构造器参数类型现在强制协变，8.1 的类型检查器会拒绝实例化路由属性。
立即学习“PHP免费学习笔记（深入）”；
这些不是警告，是立即中断的解析或运行时错误。别赌“只用了一小部分功能”——自动加载器一碰到带新语法的类文件就会崩。
最常被忽略的一点：CI/CD 流水线里的 PHP 版本和本地开发环境必须严格一致，连 patch 版本号（如 8.2.6 vs 8.2.12）差异都可能导致缓存生成失败或测试通过率波动。
