在 macOS 上配置 Symfony 开发环境的核心是先通过 Homebrew 安装并灵活管理多版本 PHP（如 php@8.1、php@8.2），使用 brew unlink 与 brew link --force 切换 CLI 默认版本，通过 PATH 置顶和 ~/.zshrc 配置确保终端生效，为 Nginx/Apache 配置独立 PHP-FPM 端口（如 9081/9082），再安装 Composer、Xdebug 和 Symfony CLI 并验证一致性。
在 macOS 上装 Symfony，核心不是直接下框架，而是先搭好灵活、可控的底层环境——尤其是 PHP 多版本共存能力。Homebrew 是目前最稳定、社区支持最完善的方案，它让安装、切换、隔离不同 PHP 版本变得可预测且可复现。
装 Homebrew 并确认基础可用
这是所有后续操作的前提。打开终端，运行：
- 安装命令（推荐国内镜像加速）：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
- 验证是否成功：brew --version 应输出版本号（如 4.3.x）
- 更新索引：brew update
安装多个 PHP 版本并管理链接
Symfony 不同版本对 PHP 有明确要求（例如 Symfony 6.4 要求 PHP 8.1+，Symfony 7 已要求 PHP 8.2+）。你需要至少两个常用版本（如 8.1 和 8.2）共存：
- 添加官方 PHP tap（支持旧版）：brew tap shivammathur/php
- 安装指定版本（示例）：brew install php@8.1 php@8.2
- 查看当前链接：brew list --versions | grep php
- 切换默认 CLI 版本（比如切到 8.1）：brew unlink php && brew link --force php@8.1
注意：仅执行 link/unlink 不够，还需确保 shell 的 PATH 指向正确路径（如 /opt/homebrew/opt/php@8.1/bin），并在 ~/.zshrc 中置顶该路径，再运行 source ~/.zshrc 生效。
立即学习“PHP免费学习笔记（深入）”；
配置 PHP-FPM 端口避免冲突
如果你用 Nginx 或 Apache 做 Web 服务，多个 PHP 版本必须监听不同端口，否则启动会失败：
- 编辑 /opt/homebrew/etc/php/8.1/php-fpm.d/www.conf，修改：
listen = 127.0.0.1:9081 - 同理，为 8.2 版本设为 listen = 127.0.0.1:9082
- 启动对应服务：brew services start php@8.1 和 brew services start php@8.2
可通过 lsof -i :9081 验证端口是否被正确占用。
装 Composer、Xdebug 与 Symfony CLI
这些是开发链路中不可跳过的环节：
- Composer：brew install composer，再换国内源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Xdebug：pecl install xdebug，然后确认 php --ini 显示的 Loaded Configuration File 路径下，php.ini 包含 zend_extension="xdebug.so"
- Symfony CLI：curl -sS https://get.symfony.com/cli/installer | bash，再把 bin 目录加入 PATH（如 export PATH="$HOME/.symfony/bin:$PATH"）
最后验证：symfony new my_project --version=stable 应能成功创建项目，并在 php -v 和 symfony server:start 中体现当前 PHP 版本一致性。
