Composer如何创建Symfony项目_Composer创建Symfony项目思路-composer-PHP中文网

最可靠方式是用 composer create-project symfony/skeleton 创建项目，它自动处理依赖、autoload、入口绑定等；手动建 composer.json 易漏 symfony 特有逻辑，导致 console 报错或路由失效。

composer如何创建symfony项目_composer创建symfony项目思路

直接用 create-project 命令，别手动生成 autoload 或手动 require

Composer 创建 Symfony 项目最可靠的方式就是调用 create-project，它会自动下载对应版本的 Symfony 框架骨架（skeleton），并完成依赖安装、autoload 注册、权限检查等。手动生成 composer.json 后再 composer install 容易漏掉 Symfony 特有的引导逻辑（比如 public/index.php 的入口绑定、config/bundles.php 的自动注册机制），导致后续 bin/console 报错或路由不生效。

推荐命令：

composer create-project symfony/skeleton my-project

如果需要特定版本（如 7.1）：

composer create-project symfony/skeleton:^7.1 my-project

不加 ^ 可能因版本约束太松而装到非 LTS 版本，线上环境慎用
项目名 my-project 不能含大写字母或特殊符号，否则部分 Symfony 组件（如 MakerBundle）生成类时会出问题
执行后会自动运行 composer install，无需再手动执行

安装 Webpack Encore 或其他官方包时，注意 dev vs prod 环境标记

Symfony 官方推荐的前端构建工具是 Webpack Encore，但它默认只在 dev 环境下启用。如果你执行 composer require symfony/webpack-encore-bundle 后发现 assets:install 报错或 CSS 不加载，大概率是因为你没区分环境——该包的配置文件 config/packages/webpack_encore.yaml 默认带 when@dev 条件。

常见操作误区：

在生产环境运行 npm run build 却忘了先执行 APP_ENV=prod composer install --no-dev，导致 node_modules 被删，build 失败
把 symfony/webpack-encore-bundle 放进 require-dev，结果正式部署时 bundle 找不到，Encore 类无法加载
assets:install 命令在 APP_ENV=prod 下默认跳过软链接（因安全限制），需显式加 --symlink 参数才能让 public/build/ 正确指向 public/build/

vendor/bin/simple-phpunit 和 bin/phpunit 的区别必须分清

新 Symfony 项目里会出现两个 PHPUnit 可执行文件：vendor/bin/simple-phpunit 和 bin/phpunit。前者是 Symfony 提供的封装脚本，会自动下载匹配当前 Symfony 版本的 PHPUnit PHAR；后者是你自己配置的、可能指向全局或旧版本 PHPUnit 的二进制。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

直接运行 bin/phpunit 很容易报错：

Class 'PHPUnit\Framework\TestCase' not found：因为 bin/phpunit 没走 Composer autoloader，也未加载 Symfony 的测试引导逻辑
PHP Fatal error: Uncaught Error: Class "Symfony\Bundle\FrameworkBundle\Test\KernelTestCase"：说明测试用例继承了 Symfony 测试基类，但 bin/phpunit 没载入 autoload-dev 或未初始化 Kernel

正确做法是统一用：

./vendor/bin/simple-phpunit

它会自动处理 PHPUnit 版本对齐、phpunit.xml.dist 加载、以及 SYMFONY_PHPUNIT_VERSION 环境变量控制。

升级 Symfony 主版本前，先跑 composer update --dry-run

很多人在 composer.json 里把 "symfony/*": "^6.4" 改成 "^7.0" 后直接 composer update，结果 CI 突然失败，本地也一堆 Class not found 或 Deprecated: Method xxx is deprecated。这是因为 Symfony 7 移除了大量旧组件（如 symfony/templating）、重命名了服务 ID（如 doctrine.dbal.default_connection → doctrine.dbal.default_connection 不再存在），还强制要求 PHP 8.2+。

建议流程：

先改 composer.json 中的版本约束
运行 composer update --dry-run --with-dependencies，看哪些包会被升级/降级/移除
重点检查 symfony/framework-bundle、symfony/http-kernel、symfony/console 是否同步升级，避免混用 v6 和 v7 组件
查看 UPGRADE-7.0.md 中的 breaking changes，尤其是 Doctrine、Messenger、Cache 组件的变更点

实际升级不是改个数字就完事，框架内核和服务容器的行为变化会穿透到业务代码里，比如 Request::getContentType() 在 7.0 中已废弃，得换成 getContentTypeFormat() —— 这类细节不会被 --dry-run 提示，只能靠文档和测试覆盖兜底。