必须将Mac的PHP升级至8.2+才能安装Symfony 7.1，先用Homebrew安装并强制链接php@8.2，再通过Symfony官方安装器或Composer本地创建项目，并配置platform锁定PHP版本以避免依赖冲突。
在Mac上安装Symfony 7.1时，Composer报错提示“symfony/console v7.1 requires php >=8.2”，但系统PHP版本仍为8.1或更低，导致全局安装失败或项目初始化中断。
确认当前PHP版本与Symfony 7.1要求
打开终端，执行：php -v。若输出显示 PHP 8.1.28 或更低版本，即不满足 Symfony 7.1 的最低要求（PHP ≥8.2）。不要跳过这步——很多用户误以为 Homebrew 安装的 php 就是最新版，实际可能是旧版残留或未正确链接。
运行 which php 查看PHP路径。如果返回 /usr/bin/php，说明你用的是macOS自带PHP（已废弃且版本极低），【必须切换到Homebrew管理的PHP】。
升级并激活PHP 8.2+（Homebrew方案）
第一步：更新Homebrew并升级PHP
执行：brew update && brew upgrade php。这会拉取最新稳定版PHP（当前为8.2.x或8.3.x）。
立即学习“PHP免费学习笔记（深入）”；
第二步：检查已安装PHP版本列表
运行：brew services list | grep php，确认是否有 php@8.2 或 php@8.3 在线服务。若无，需先安装：brew install php@8.2。
第三步：强制重链接PHP二进制文件
执行：brew unlink php && brew link --force php@8.2。这一步很关键——Homebrew默认不自动覆盖旧链接，【不执行--force会导致php -v仍显示旧版本】。
第四步：验证生效
再次运行 php -v，应输出类似 PHP 8.2.24；再执行 which php，路径应为 /opt/homebrew/bin/php（Apple Silicon）或 /usr/local/bin/php（Intel）。
安装Symfony 7.1（两种安全方式）
方法一：使用Symfony官方安装器（推荐新手）
下载并运行安装脚本：curl -sS https://get.symfony.com/cli/installer | bash，然后将 ~/.symfony/bin 加入PATH。之后直接执行：symfony new my_project --version=7.1。该方式绕过Composer全局依赖，自动匹配PHP版本。
方法二：通过Composer本地安装（适合已有项目）
进入项目目录后，执行：composer create-project symfony/skeleton my_project "7.1.*"。注意：必须确保当前shell中 php 命令已指向8.2+，否则Composer仍会读取旧PHP环境并报错。
⚠️ 提醒：不要运行 composer global require symfony/cli——该命令会复用全局Composer配置，而全局环境很可能仍锁定旧PHP版本，极易触发依赖冲突。
修复因PHP版本混用导致的Composer lock失效
步骤一：清除Composer缓存避免旧版本干扰composer clear-cache
步骤二：强制刷新平台配置
编辑项目根目录下的 composer.json，在 "config" 节点下添加："platform": {"php": "8.2.24"}。这告诉Composer：“即使当前环境PHP是8.2.24，也请按此版本解析依赖”，防止其误判为低版本而拒绝安装Symfony 7.1。
步骤三：重新生成锁文件composer update --lock。该命令不修改vendor，仅重算并写入兼容PHP 8.2的精确依赖版本，比 composer install 更安全可靠。
