PHP 8.2 是 Symfony 7 的硬性门槛，缺 intl、mbstring、xml、curl、fileinfo 中任意扩展或 Composer 插件未启用，symfony new 将在依赖解析阶段报错退出；必须验证 php -v、php -m、php --ini 三者一致，且执行 composer config -g allow-plugins true 和配置国内镜像源。
直接说结论：PHP 8.2 是 Symfony 7 的硬性门槛，缺 intl、mbstring、xml、curl、fileinfo 这五个扩展中的任意一个，symfony new 都会卡在依赖解析阶段报错退出——不是页面打不开，是项目根本建不起来。
确认 PHP 8.2 是否真正生效
很多人执行 php -v 看到 8.2.x 就以为万事大吉，但实际可能只是 Homebrew 或 apt 安装了，PATH 没对齐或系统仍调用旧版本。关键看三件事：
-
which php输出路径必须是/opt/homebrew/bin/php（macOS）、/usr/bin/php8.2（Ubuntu）或/usr/bin/php（CentOS + Remi），不能是/usr/bin/php（系统自带） -
php -m | grep -E "^(intl|mbstring|xml|curl|fileinfo)$"必须一次性输出全部五项，intl尤其容易漏——Homebrew 默认不装，CentOS 需手动yum install php-intl -
php --ini查看加载的php.ini路径，编辑它确保extension=intl等行未被注释，且没重复启用同一扩展
Composer 安装后必须补的关键配置
Composer 2.7+ 默认禁用插件，而 Symfony 7 的依赖注入和资产构建依赖 symfony/flex 插件，不放开就会在 symfony new 时抛出 plugins are disabled 错误。
- 运行
composer config -g allow-plugins true全局启用插件 - 国内用户务必设镜像源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer global show应列出symfony/flex，否则后续symfony new会跳过自动配置步骤，导致public/index.php缺失或路由不生效
symfony new --webapp 为什么比 create-project 更可靠
用 composer create-project symfony/skeleton 创建的项目，本质是空骨架，不带 Twig、Webpack Encore、Doctrine 预配置；而 symfony new myapp --webapp 会自动触发 Flex 插件，下载并执行 recipe，完成以下动作：
立即学习“PHP免费学习笔记（深入）”；
- 写入
config/packages/twig.yaml和templates/base.html.twig - 初始化
assets/app.js并配置 Encore 构建脚本 - 生成
.env.local并预设APP_ENV=dev和APP_DEBUG=1 - 注意：
--full参数已在 2025 年底废弃，强行使用会触发 Flex 报错退出
启动失败时优先检查 server:start 的监听地址
symfony server:start 默认绑定 127.0.0.1:8000，但 macOS Monterey+ 或某些 Linux 发行版会默认启用 IPv6 回环，导致浏览器访问 http://localhost:8000 失败（实际服务在 [::1]:8000）。
- 运行
symfony server:status查看真实监听地址，通常显示为https://127.0.0.1:8000或https://[::1]:8000 - 若看到
[::1]，请改用http://[::1]:8000访问，或加参数强制 IPv4：symfony server:start --address=127.0.0.1:8000 - 首次启动时若提示证书问题，执行
symfony server:ca:install即可，无需重启服务
最常被忽略的是：Symfony 7 的 public/index.php 不再直接 require vendor/autoload.php，而是通过 vendor/autoload_runtime.php 加载轻量内核——这意味着你不能用 php -S 手动起服务，必须用 symfony server:start 或 php bin/console server:run（后者已标记为 deprecated，仅兼容）。
