Symfony3.4升级到4.4_逐步升级策略【汇总】

1次阅读

需将 security.yaml 中的 ‘%secret%’ 替换为 ‘%env(APP_SECRET)%’，确保 .env 含 APP_SECRET，删除旧 parameters 文件，并验证 kernel.secret 参数。

Symfony3.4 升级到 4.4_逐步升级策略【汇总】

这个错误不是配置写错了，而是 Symfony 4.4 彻底移除了全局 secret 参数的自动注入机制。它现在只认 kernel.secret（由 APP_SECRET 环境变量驱动），但旧版 security.yaml 里还写着 remember_me: secret: '%secret%'，框架一读就炸。

检查 config/packages/security.yaml，把所有 '%secret%' 替换成 '%env(APP_SECRET)%'
确保 .env 文件里有 APP_SECRET=……（长度建议 32 位以上）
删除任何残留的 app/config/parameters.yml 或 parameters.php —— Symfony 4.4 不再从那里加载参数
运行 php bin/console debug:container --parameter=kernel.secret 验证是否能正常输出

不改这里，cache:clear 和所有命令都会失败，哪怕 framework.yaml 里已经配好了 secret。

Symfony 官方明确不支持跨 LTS 直升（比如 3.4 → 4.4），但也不强制你逐个小版本过（3.4→4.0→4.1→……→4.4）。实际可行路径是：3.4 → 4.0 → 4.4，每步只动最小范围。

第一步：只升级 symfony/framework-bundle 和 symfony/http-kernel 到 ^4.0，其他保持 ^3.4
第二步：跑 php bin/console cache:clear 和 php bin/console debug:router，修复 Kernel::registerBundles() 返回类型、AppKernel 类名变更等基础报错
第三步：升级 symfony/twig-bundle、symfony/orm-pack 等官方 Bundle，注意 doctrine/doctrine-bundle 从 1.x 升到 2.x 时 doctrine.dbal 版本需同步匹配
最后才碰自定义代码：比如手动调用 $this->get('service') 的地方，得改成构造器注入；ContainerAwareTrait 全部删掉

跳过中间步骤直接全量 composer update，大概率会触发一堆冲突，比如 symfony/console 要求 PHP 7.1+，而你的 monolog-bundle 还卡在 3.x，根本拉不下来。

Symfony 4 引入 Flex 后，很多配置会自动写进 config/packages/，看着省事，但容易掩盖问题。

运行 composer require symfony/flex 后，先别急着 composer update
查看 composer.json 里是否已加 "extra": {"symfony": {"allow-contrib": false}}，没加就补上，避免第三方 recipe 干扰
升级后检查 config/bundles.php，确认每个 bundle 的启用条件（如 if (class_exists(……))）是否还成立
Flex 自动生成的 config/packages/framework.yaml 里可能含冗余项（比如 form: true 在没装 symfony/form 时会报错），要按需删

Flex 不会帮你改业务逻辑，也不会告诉你 doctrine:generate:entities 命令已在 4.0 废弃——它只管“配好”，不管“跑通”。

Symfony 3.4 到 4.4 的最大坑不在语法，而在隐性行为变化：

运行 php bin/console debug:deprecations，重点看 ContainerAwareInterface、get() 方法、getDoctrine()->getManager() 的调用位置
Doctrine ORM 升级到 2.6+ 后，nullable=false 字段默认不再生成 NOT NULL 约束，php bin/console doctrine:schema:update --dump-sql 可能输出意外的 ALTER TABLE
表单验证规则里用的 @AssertNotBlank 在 4.4 默认开启 strict=true，空字符串会被当 null 处理，导致验证失败