Symfony 6.4 要求 PHP 8.1+，低于则安装或启动即报错；必须启用 mbstring、json、xml、curl、pdo 扩展；APP_ENV 需设为 dev 且 vendor/autoload.php 不可缺失；升级至 7.x 需 PHP 8.2+。
Symfony 6.4 要求 PHP 8.1+，低于这个版本直接报错
不是警告，是安装或启动阶段就中断——composer create-project 会拒绝执行，php bin/console 会提示 ParseError: syntax error, unexpected token "string" 或类似致命错误。这是因为 Symfony 6.4 大量使用了 PHP 8.1 的新语法（如 readonly 属性、枚举构造函数参数提升等），底层组件如 symfony/contracts 和 symfony/runtime 也已硬性声明 "php": ">=8.1"。
- 用
php -v确认当前版本；若显示8.0.30或更低，必须升级 PHP，不能靠composer install --ignore-platform-reqs强行绕过 - 某些 Linux 发行版默认源里的 PHP 版本太旧（如 Ubuntu 22.04 默认 PHP 8.1，但 CentOS 7 默认只有 5.4），需手动添加第三方仓库（如
ondrej/php）或编译安装 - Docker 用户注意：基础镜像不能写
php:8.0-apache，得换php:8.1-apache或更高；本地 Homestead/Valet 同理，要检查实际运行的 PHP CLI 版本，而非 Web 服务器模块版本
PHP 扩展缺失比版本低更常见，mbstring 缺失是头号拦路虎
即使 PHP 是 8.1，composer create-project symfony/skeleton:"6.4.*" 也可能失败，并抛出明确错误：PHP extension "mbstring" is required。这不是 Symfony 特有，而是其依赖的 symfony/polyfill-mbstring 和底层 YAML/JSON 解析器强依赖该扩展。
- 检查是否启用：
php -m | grep mbstring；没输出说明未加载，需编辑php.ini，取消;extension=mbstring前的分号，然后重启 PHP-FPM 或 Apache - 必须同时启用的还有：
json、xml、curl、pdo（哪怕不用数据库，symfony/framework-bundle初始化时也会探测 PDO 类是否存在） - Windows 用户容易忽略：
php.ini文件可能有多个（CLI 用一个，Apache 模块用另一个），务必确认php -i | grep "Loaded Configuration File"显示的是你修改的那个
装完跑不起来？很可能是 APP_ENV 没设对，或 vendor/autoload.php 被误删
Symfony 6.4 默认使用 APP_ENV=dev 启动开发服务器，但如果你手动改过 .env 或导出了系统环境变量，却设成了 prod，又没跑 composer install --no-dev --optimize-autoloader，就会触发 Warning: require(/vendor/autoload.php): failed to open stream —— 因为生产模式下自动加载器被优化，但 vendor/ 目录结构或缓存不完整。
- 快速验证：
php -S localhost:8000 -t public启动前，先执行echo $APP_ENV（Linux/macOS）或echo %APP_ENV%（Windows），确保是dev - 如果提示找不到
autoload.php，别急着重装，先ls -l vendor/autoload.php；若文件不存在，大概率是之前执行过composer install --no-autoloader，此时只需composer dump-autoload重建即可 -
.env文件里不要写APP_ENV=prod就直接跑开发命令，这是新手高频误操作
从 6.4 升级到 7.x？PHP 版本门槛直接跳到 8.2+
如果你现在用的是 Symfony 6.4，未来打算升 7.x（比如 7.1 或 7.2），PHP 版本要求会立刻变成 >=8.2。这不是可选配置，是 composer.json 里硬编码的 "php": ">=8.2"，且 7.x 移除了所有对 PHP 8.1 兼容的 polyfill。
立即学习“PHP免费学习笔记（深入）”；
- 提前检查：
php -r "echo version_compare(PHP_VERSION, '8.2.0', '>=') ? 'OK' : 'Need upgrade';" - 升级 PHP 8.2 后，还要注意：部分扩展（如
apcu、opcache）需重新编译或更新 PECL 包，否则php -m会报错或缺失 - 别指望 Symfony Flex 自动处理 PHP 版本切换——它只管组件，不管运行时。升级前务必在 CI 或本地测试环境完整走一遍
composer update+php bin/console cache:clear+ 接口冒烟测试
.env 里静默覆盖了 APP_ENV 导致开发命令行为异常。 
