安装Symfony CLI环境需三步：先装PHP（≥7.4）并启用mbstring、xml、intl、openssl扩展；再全局安装Composer并配置国内镜像源；最后通过官方安装包（Windows）或Homebrew（macOS）安装Symfony CLI，执行symfony new --full创建项目并用symfony server:start启动。
Windows 和 macOS 安装 Symfony 命令行环境，核心是三步：装好 PHP（≥7.4）、配好 Composer、再装 Symfony CLI 工具。不依赖旧版 installer 脚本，也不用手动管理 symfony.bat 或 Phar 文件——官方已全面转向 CLI 工具链，更稳定、更新快、集成度高。
一、确认并安装 PHP（必须）
Symfony 运行离不开 PHP。Windows 与 macOS 都需确保命令行中能直接调用 php：
-
Windows：推荐使用 php.net 官方 Windows 二进制包（VC15 x64 Thread Safe 版本），解压后将
php.exe所在目录（如D:\php）添加到系统 PATH 环境变量；启用关键扩展：取消php.ini中extension=mbstring、extension=xml、extension=intl、extension=openssl的注释；保存后运行php -v和php -m | findstr intl验证。 -
macOS：用 Homebrew 最省心：
brew install php（自动安装 PHP 8.x 并配置 PATH）；执行php -v和php -m | grep intl确认 intl 扩展已加载。
二、安装并配置 Composer（必需）
Composer 是 Symfony 项目依赖管理的基石，必须全局可用：
windows-shell-syntax
下载
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
- 下载安装器：Windows 直接运行 Composer-Setup.exe；macOS 执行：
curl -sS https://getcomposer.org/installer | php，再sudo mv composer.phar /usr/local/bin/composer。 - 验证：
composer --version应输出版本号（如 2.7+）。 - 提速建议（国内用户必做）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
三、安装 Symfony CLI（推荐方式）
这是目前最主流、最可靠的安装路径，比 composer global require symfony/cli 更少出错：
-
Windows：下载 Symfony CLI for Windows（.exe 安装包），双击运行，默认完成 PATH 注册；安装后重启终端，执行
symfony version查看版本。 -
macOS：终端执行：
brew install symfony-cli/tap/symfony-cli；验证同上。 - ⚠️ 若用
composer global require symfony/cli失败（提示 command not found），大概率是 Composer 全局 bin 目录未加入 PATH：
– Windows：把%APPDATA%\Composer\vendor\bin加入系统 PATH；
– macOS：在~/.zshrc中追加export PATH="$HOME/.composer/vendor/bin:$PATH"，然后source ~/.zshrc。
四、创建并启动第一个项目（快速验证）
环境就绪后，一条命令即可生成可运行项目：
- 执行：
symfony new my_project --full（--full包含 Twig、Doctrine、Webpack Encore 等常用组件，新手首选）。 - 进入项目：
cd my_project。 - 启动开发服务器：
symfony server:start（自动处理 HTTPS、PHP 配置、路由重写等）。 - 打开浏览器访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913，看到 Symfony 欢迎页即表示全部成功。
整个过程不涉及手动改配置、不依赖 Apache/Nginx、无需处理 SSL 证书或 Phar 权限问题。只要 PHP 和网络正常，10 分钟内就能跑起一个标准 Symfony 开发环境。
