Mac上运行Symfony需四步：装Homebrew、用brew install php@8.2并启用gd/mbstring/xml扩展、安装Composer和Symfony CLI、执行symfony new my_project --webapp后symfony server:start启动。
要在Mac上运行Symfony项目，必须先让PHP环境支持Composer和Symfony CLI，系统自带的PHP版本过旧且不带常用扩展，直接使用会导致安装失败或功能异常。
安装Homebrew并配置基础工具链
打开终端，粘贴执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。等待安装完成，期间可能提示输入管理员密码。
安装完成后运行 brew --version 确认返回版本号；若报错“command not found”，需将Homebrew路径加入shell配置文件——对zsh用户执行 echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc。
安装PHP 8.2+并启用关键扩展
执行 brew install php@8.2，Homebrew会自动链接到 /opt/homebrew/bin/php。
立即学习“PHP免费学习笔记（深入）”；
检查PHP是否生效：php -v 应显示 8.2.x 版本；若仍显示系统默认的 8.1 或更低版本，【必须手动修改PATH顺序，确保 /opt/homebrew/bin 在 /usr/bin 前】。
编辑 php.ini：运行 brew --prefix php@8.2 获取路径，再执行 open $(brew --prefix php@8.2)/etc/php/8.2/php.ini，取消以下三行前的分号：;extension=gd;extension=mbstring;extension=xml
保存后重启终端，用 php -m | grep -E "^(gd|mbstring|xml)$" 验证扩展已加载。
安装Composer并验证全局可用性
在终端中运行：curl -sS https://getcomposer.org/installer | php → sudo mv composer.phar /usr/local/bin/composer → chmod +x /usr/local/bin/composer。
执行 composer --version，输出应为 2.7.x 或更高；若提示 “Permission denied”，说明上一步 chmod 失败，需重新执行权限赋值。
安装Symfony CLI并创建首个项目
方法一（推荐）：运行 curl -sS https://get.symfony.com/cli/installer | bash → export PATH="$HOME/.symfony/bin:$PATH" → source ~/.zshrc。
方法二（备用）：用Composer全局安装 composer global require symfony/cli，但需确保 ~/.composer/vendor/bin 已加入PATH。
验证安装：symfony version 应返回 v5.10+；若报错 “command not found”，说明PATH未生效，需重新加载shell配置或重启终端。
创建新项目：symfony new my_project --webapp。这一步会自动下载骨架、安装依赖、初始化Git仓库；【不要在已有Git仓库内执行，否则会破坏原.git目录】。
进入项目目录：cd my_project → 启动开发服务器：symfony server:start。浏览器访问 https://127.0.0.1:8000，看到Symfony欢迎页即表示环境配置成功。
