新手安装 symfony 应优先使用 symfony cli 创建完整项目，其次可选 composer 骨架方式；需确保 php 8.1+、必要扩展及 composer 已正确安装并配置 path。

安装 Symfony 对新手来说不难，关键在选对方式、避开常见坑。现在主流做法是用 Symfony CLI 或 Composer 创建项目，不再推荐旧版安装器（已停更）。Windows 和 macOS 步骤高度一致，差异仅在命令写法和路径处理上。

一、基础环境必须配齐

无论用哪种方式，以下三样缺一不可：

• PHP 8.1+：检查命令 php --version；若未安装，去 windows.php.net（Win）或用 brew install php（macOS）获取
• 启用必要扩展：编辑 php.ini，确保开启 openssl、mbstring、xml、tokenizer；Windows 用户注意取消 ;extension=php_openssl.dll 前的分号
• Composer 已就位：运行 composer --version 验证；如未装，Windows 下运行 composer-setup.exe，macOS 执行：
  curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer

二、推荐新手：用 Symfony CLI 一键建完整项目

它自动集成 Twig、Doctrine、Webpack Encore、Security 等常用组件，省去手动配置麻烦，适合第一次跑起来看效果。

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

• macOS：终端执行
  brew install symfony-cli/tap/symfony-cli
• Windows：下载官方 Symfony CLI 安装包，双击运行即可
• 验证安装：symfony version 应显示版本号
• 创建项目：symfony new my_project --webapp（--webapp 是当前新版替代 --full 的参数）
• 启动服务：cd my_project && symfony server:start，浏览器打开 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913 看到欢迎页即成功

三、备选方案：用 Composer 创建轻量骨架项目

适合想了解按需加载机制、或准备做 API/微服务的同学。结构极简，后续组件随用随装。

• 执行命令：composer create-project symfony/skeleton my_project
• 进入目录后，先装开发依赖：composer require webapp（自动补全 Twig、Router、Form 等基础 Web 功能）
• 启动内置服务器：php -S 127.0.0.1:8000 -t public，或装了 Symfony CLI 就直接 symfony server:start
• 对比 CLI 方式，此法初始无控制器、无模板目录，需手动运行：composer require maker-bundle --dev，再执行 php bin/console make:controller Homepage 才能生成页面

四、安装失败？先查这三处

90% 的卡点集中在这几个地方：

• SSL 报错（cURL error 60）：Windows 用户检查 php.ini 中 openssl.cafile 是否指向有效的 cacert.pem；可去 curl.se/ca/cacert.pem 下载并配置
• “command not found” 类提示：确认 PHP、Composer、Symfony CLI 的安装路径已加入系统 PATH；macOS 可用 echo $PATH 查看，Windows 在「系统属性 → 高级 → 环境变量」中检查
• 启动时报 “Class not found” 或空白页：进项目目录执行 composer install 补全依赖；再清缓存：php bin/console cache:clear