在 Mac 上，用 Composer 创建 Symfony 项目，其实一条命令就够了：composer create-project symfony/skeleton my-project。

执行后，它会直接帮你生成标准的项目结构，并把依赖一并自动安装好。

前提是环境得先准备到位：PHP 版本至少为 8.1，Composer 已经安装完成，而且能够正常访问 Packagist。

至于骨架选择，通常建议根据实际需求来定，轻量场景用 skeleton，更完整的场景可以选 website-skeleton。

另外还有一点很关键，别把 symfony/symfony 这个源码仓库当成项目骨架来用，这两者不是一回事。

在 Mac 上用 Composer 创建 Symfony 项目，关键其实就这一条命令：composer create-project symfony/skeleton my-project。

它并不是简单意义上的“装框架”，而是直接拉下来一个标准化、能立即跑起来的项目起点。

目录结构有了，基础配置带上了，依赖安装也会自动完成。

和手动一点点拼相比，这种方式显然更快，也更稳。

先确认环境是否到位

别急着敲命令，先检查三件事：

• PHP 版本 ≥ 8.1：Symfony 7.x（当前主流）强制要求 PHP 8.1+。运行 php -v 确认；若版本偏低，推荐用 brew install php 升级
• Composer 已全局可用：运行 composer --version 应返回版本号。没装？用 curl -sS https://getcomposer.org/installer | php 安装后，再执行 sudo mv composer.phar /usr/local/bin/composer
• 网络能通 Packagist：国内用户常因镜像源滞后导致找不到 symfony/skeleton。临时切回最新源：composer config -g repo.packagist composer https://packagist.org

选对骨架，一步到位

根据你要做的项目类型，选一个骨架启动：

• API 或轻量服务：用最小骨架 composer create-project symfony/skeleton my-api。它只有 Kernel、基础路由和配置，干净无冗余
• 带页面的传统 Web 项目：用完整骨架 composer create-project symfony/website-skeleton my-site。它默认包含 Twig、Doctrine、Webpack Encore 和 Web Server Bundle，开箱就能 php -S localhost:8000 -t public 启动
• 别碰 symfony/symfony：那是框架源码仓库，不是项目模板，不能直接运行

常见卡点与快速修复

命令执行中遇到报错，大概率是这几个原因：

• “Could not find package”：90% 是镜像源问题。先清缓存 composer clear-cache，再切回最新源重试
• “Directory my-project exists and is not empty”：目标文件夹已存在且非空。删掉再跑，或换新目录名。Composer 不覆盖已有项目
• 执行完没有 vendor/autoload.php：说明 composer install 没走完。进项目目录手动补一句 composer install --no-interaction
• 启动时报 “No route found”：symfony/skeleton 默认不带任何路由。

最简处理方式

在 config/routes.yaml 里写两行：

app:
path: /
controller: SymfonyComponentHttpKernelControllerErrorController::showAction

或直接装 Webpack Encore + Twig 再写控制器。

后续建议动作

项目创建成功后，立刻做三件小事，省去后续很多麻烦：

• 进项目目录，运行 git init && git add . && git commit -m "init"，方便后续回溯和协作
• 检查 .env 文件，按需修改数据库、密钥等配置。首次运行前建议生成新密钥：php bin/console secrets:generate-keys
• 想本地预览？不用配 Apache/Nginx：cd my-project && php -S localhost:8000 -t public 直接启动内置服务器

《夸克》非常好用的免费AI浏览器

下载APP查看