安装 symfony 在 windows 和 macos 上流程高度一致,关键在三步:装好 php(≥8.1)、配妥 composer、再用 symfony cli 创建并启动项目;内置 web 服务器无需 apache/nginx,一条命令即可跑起来。

安装 Symfony 在 Windows 和 macOS 上流程高度一致,关键在三步:装好 PHP(≥8.1)、配妥 Composer、再用 Symfony CLI 创建并启动项目。内置 Web 服务器无需 Apache/Nginx,一条命令即可跑起来。
PHP 环境准备
必须确保 PHP 命令行可用,且启用必要扩展:
- Windows:从 php.net 下载 VC15 x64 Thread Safe 版本,解压后将目录(如
D:\php)加入系统 PATH;编辑php.ini,取消以下行前的分号:extension=mbstring、extension=xml、extension=intl、extension=openssl、extension=fileinfo - macOS:推荐用 Homebrew 安装:
brew install php,自动配置 PATH 和常用扩展;运行php -v和php -m | grep intl验证 - 共通验证:终端执行
php -v应显示 8.1 或更高版本;php -m中应包含intl、mbstring等模块
Composer 与 Symfony CLI 安装
两者均为全局命令,需一次配置、长期使用:
- Composer:Windows 运行官方
Composer-Setup.exe;macOS 执行:curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer;验证:composer --version - Symfony CLI:
– macOS:brew install symfony-cli/tap/symfony-cli
– Windows:下载symfony-cli-windows-amd64.exe(官网最新版),重命名为symfony.exe,放入C:\Windows或其他 PATH 目录
验证:symfony version显示版本号即成功 - 国内用户建议为 Composer 设置阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
创建项目并启动内置服务器
推荐使用 CLI 方式,开箱即用:
- 执行:
symfony new my_project --webapp(--webapp是当前替代旧--full的标准参数,含 Twig、Doctrine、Webpack Encore 等) - 进入项目:
cd my_project - 启动服务:
symfony server:start,终端会输出类似Local web server started: http://127.0.0.1:8000 - 打开浏览器访问
http://127.0.0.1:8000,看到 “Congratulations! Your application is working.” 即表示成功 - 若端口被占,可指定新端口:
symfony server:start --port=8080
无 CLI 时的备选启动方式
如果暂未安装 Symfony CLI,仍可用 PHP 内置服务器启动:
- 确保已执行
composer install(首次创建后通常自动完成) - 运行:
php -S 127.0.0.1:8000 -t public(注意必须加-t public,否则路由不生效) - 访问地址同上:
http://127.0.0.1:8000 - 该方式不支持 HTTPS 模拟或实时重载,仅用于快速验证











