本文旨在解决 Symfony 从 3.4 升级到 4.4 时出现的“secret”参数不存在错误。该问题通常源于旧版本 security.yaml 中遗留的 secret: ‘%secret%’ 配置与 Symfony 4.4+.env 参数管理机制的冲突。教程将详细指导如何通过注释或移除 security.yaml 中冲突的配置来快速解决此问题，确保升级后的应用正常运行。
引言
Symfony 框架在不同版本之间进行了大量改进和重构，尤其是在参数管理方面。从 Symfony 3.4 升级到 4.4 是一个重要的版本跨越，其中一个显著变化是移除了 app/config/parameters.yml，转而使用。env 文件来管理 环境变量 和应用秘密（Application Secret）。在升级过程中，开发者可能会遇到一个常见的错误：“You have requested a non-existent parameter “secret”. Did you mean this: “kernel.secret”?”。本教程将深入探讨此错误的原因及提供明确的解决方案。
问题描述
当尝试将 Symfony 项目从 3.4 升级到 4.4，并按照新版本的约定将 secret 参数配置为从。env 文件加载（例如在 config/packages/framework.yaml 中配置 secret: ‘%env(APP_SECRET)%’）时，运行终端命令（如php bin/console cache:clear 或composer dump-env dev）可能会抛出以下错误：
In ParameterBag.php line 95: You have requested a non-existent parameter "secret". Did you mean this: "kernel.secret"?尽管 composer dump-env dev 命令可能显示 APP_SECRET 已正确加载，但应用仍然报告 secret 参数不存在。这表明问题可能不在于 APP_SECRET 本身，而在于某个配置尝试以错误的方式引用它。
错误根源分析
此错误的核心原因在于 Symfony 3.4 和 4.4 在处理 secret 参数上的差异。在 Symfony 3.4 及更早版本中，secret 通常作为独立的参数定义，并在某些捆绑包（如 security 组件的 remember_me 功能）中直接引用。然而，在 Symfony 4.4 及更高版本中，应用程序的秘密（Application Secret）通常通过 APP_SECRET 环境变量在 framework.yaml 中配置，并由框架内部映射到 kernel.secret。
当升级时，如果 security.yaml 中仍然保留了 Symfony 3.4 风格的 remember_me 配置，例如：
# security.yaml (旧版本配置示例） security: # …… firewalls: main: # …… remember_me: secret: '%secret%' # 这里的 '%secret%' 是问题所在 # ……这里的 secret: ‘%secret%’ 尝试引用一个名为 secret 的参数。但在 Symfony 4.4 环境中，这个名为 secret 的参数已经不再直接存在于参数容器中。框架期望的是 kernel.secret，而这个值通常由 framework.yaml 中的 secret: ‘%env(APP_SECRET)%’ 自动处理。因此，当 security 组件尝试解析 %secret% 时，由于找不到对应的参数，便会抛出“non-existent parameter”错误。
解决方案
解决此问题的关键是移除或注释掉 security.yaml 中对旧版 %secret% 参数的直接引用。
-
定位并修改 security.yaml 文件： 打开你的 config/packages/security.yaml 文件。
-
查找并注释或移除冲突配置： 在 remember_me 配置块下，找到类似 secret: ‘%secret%’ 的行。将其注释掉或直接删除。
修改前示例：
# config/packages/security.yaml security: # …… firewalls: main: # …… remember_me: secret: '%secret%' # <-- 这一行是问题根源 lifetime: 604800 # 1 week in seconds path: / # …… # ……修改后示例：
# config/packages/security.yaml security: # …… firewalls: main: # …… remember_me: # secret: '%secret%' # <-- 注释掉或移除此行 lifetime: 604800 # 1 week in seconds path: / # …… # ……在 Symfony 4.4+ 中，remember_me 组件通常会默认使用 kernel.secret，而无需在 security.yaml 中显式配置 secret。
-
清除 Symfony 缓存： 修改配置后，务必清除 Symfony 缓存，以确保新的配置生效。
php bin/console cache:clear如果你的环境是 dev，你可能还需要运行：
php bin/console cache:clear--env=dev
注意事项与最佳实践
-
检查 framework.yaml： 确保你的 config/packages/framework.yaml 文件已正确配置 secret 参数，使其从。env 加载 APP_SECRET：
# config/packages/framework.yaml framework: secret: '%env(APP_SECRET)%' # …… -
APP_SECRET 的定义： 确保你的项目根目录下的。env 或。env.local 文件中定义了 APP_SECRET。如果没有，可以生成一个随机字符串并添加：
# .env 或 .env.local APP_SECRET= 你的随机安全字符串可以使用 php -r “echo bin2hex(random_bytes(32));” 来生成一个安全的随机字符串。
-
版本升级的配置审查： 在进行大版本升级时，仔细审查所有 配置文件（特别是 config/packages/ 目录下的文件），并对照新版本的官方文档进行调整，是避免此类问题的最佳实践。很多时候，旧版本遗留的配置会与新版本的内部机制产生冲突。
总结
“You have requested a non-existent parameter “secret””错误在 Symfony 3.4 到 4.4 的升级中是一个常见的陷阱，它揭示了框架在参数管理和安全组件配置上的演变。通过识别并移除 security.yaml 中过时的 secret: ‘%secret%’ 配置，并确保 framework.yaml 正确地从 APP_SECRET 环境变量获取应用程序秘密，可以有效解决此问题，确保您的 Symfony 4.4 应用平稳运行。在未来的版本升级中，始终建议仔细阅读升级指南，并逐步审查和更新项目的配置。
以上就是 Symfony 3.4 到 4.4 升级指南：处理“secret”参数未定义错误的详细内容，更多请关注 php 中文网其它相关文章！
