直接用 composer create-project 一步创建 symfony 应用,无需全局安装框架;选 symfony/website-skeleton(含 twig、doctrine 等)适合 web 开发,symfony/skeleton(仅内核)适合 api;执行时加 --prefer-dist 并确保目标目录为空;启动用 symfony server:start 或 php -s 127.0.0.1:8000 -t public。

直接用 composer create-project 就能一步到位,不用装“Symfony框架”本身——它不是个可全局安装的包,而是一整套预配置好的项目结构。
选对骨架:skeleton 还是 website-skeleton?
两者都是官方推荐的起点,区别在开箱功能:
- symfony/skeleton:最小可用结构,只有 Kernel、基础配置和 CLI 工具支持,适合 API、微服务或想自己选组件的场景
- symfony/website-skeleton:自带 Twig、Doctrine、Webpack Encore、Bootstrap 示例等,适合传统 Web 页面开发,省去手动 require 多个 bundle
别用 symfony/symfony——那是源码仓库,不能直接跑;也别搜“安装 Symfony 框架”,这个说法本身就不准确。
执行命令:加 --prefer-dist 和注意目录名
推荐写法(以创建 myapp 为例):
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer create-project symfony/website-skeleton myapp --prefer-dist
-
--prefer-dist强制走压缩包安装,比 Git 克隆快得多,CI/本地都建议加上 - 目录名
myapp不能已存在(哪怕空文件夹也不行),否则会直接报错退出 - 不写版本号默认拉最新稳定版;要指定版本,比如
"7.2.*",需加引号且带约束符(^7.2或7.2.x-dev也可)
启动项目:两种方式任选其一
进项目目录后:
- 用 Symfony CLI(需提前安装):
symfony server:start,访问https://127.0.0.1:8000 - 无 CLI 时用 PHP 内置服务器:
php -S 127.0.0.1:8000 -t public
首次访问看到欢迎页,说明项目已正常运行。如果报错,先确认 public/index.php 存在且 vendor/autoload.php 已生成(没生成就手动跑 composer install)。
常见卡点与应对
遇到问题别急着重装,先看这几处:
-
Could not find package:大概率是 Composer 镜像源滞后,临时切回官方源:
composer config -g repo.packagist composer https://packagist.org -
PHP 版本不满足:Symfony 7 要求 PHP ≥ 8.1,运行
php -v确认;旧版本可能静默降级装低版 skeleton -
权限或路径问题:Windows 用户避免中文/空格路径;Linux/macOS 注意
public目录是否可读










