Symfony5.4入门：Symfony多环境配置文件加载规则讲解-php教程-PHP中文网

symfony 5.4 不自动加载 parameters_dev.yaml 等独立参数文件；多环境配置依赖 services_{env}.yaml 的条件加载机制，parameters.yaml 被所有环境共用且不可被覆盖，差异化参数应定义在 services_dev.yaml 或通过 %env(resolve:var)% 结合 .env 文件实现。

symfony5.4入门：symfony多环境配置文件加载规则讲解

Symfony 5.4 不会自动按环境名加载 parameters_dev.yaml 或 parameters_prod.yaml 这类独立参数文件。所谓“多环境配置”，本质是靠 config/services_{env}.yaml 或 config/packages/{env}.yaml 的条件加载机制实现的，不是靠文件名匹配触发的。

环境配置文件的加载顺序和优先级

Symfony 启动时按固定顺序合并配置：

config/services.yaml（所有环境都加载，基础通用配置）
config/services_{env}.yaml（如 services_dev.yaml，仅当前环境加载，可覆盖或追加前者的定义）
config/packages/*.yaml（全局包配置）
config/packages/{env}/*.yaml（如 packages/dev/cache.yaml，仅对应环境生效）

注意：parameters.yaml 属于 services.yaml 的一部分，它被所有环境共用，且其中定义的参数无法被环境文件直接覆盖——想差异化，必须用 %env()% 表达式配合 .env.local 或环境专属变量文件。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

如何让 dev 环境加载专属参数？推荐做法

不建议额外维护 parameters_dev.yaml 文件。更清晰、更安全的方式是：直接在 config/services_dev.yaml 中写死开发专用参数。

在 config/services_dev.yaml 中写：

parameters:
    app.debug_mode: true
    mailer_dsn: 'smtp://localhost:1025'

这样既避免了文件路径错误、Git 忽略遗漏等问题，也绕开了 %env()% 占位符未定义导致容器编译失败的风险
生产环境同理，services_prod.yaml 中定义 mailer_dsn: '%env(resolve:MAILER_DSN)%' 并确保 .env.prod 存在有效值

如果坚持用独立 parameters 文件，必须显式导入

例如要在 dev 环境加载 config/parameters_dev.yaml，需手动在 config/services_dev.yaml 中声明：

imports:
- { resource: 'parameters_dev.yaml' }
该文件必须真实存在于 config/ 目录下，不能被 .gitignore 忽略（否则部署时缺失）
文件内禁止出现未兜底的 %env(MY_KEY)% —— 若 .env 里没定义，容器构建直接中断

环境变量解析的缓存陷阱

%env()% 的值在容器编译期读取一次，并被缓存。本地改了 .env.local，但没清缓存，就还是旧值。

部署后务必执行：bin/console cache:clear --env=prod 和 bin/console cache:warmup --env=prod
使用 resolve: 前缀才能真正展开环境变量，比如：'%env(resolve:DATABASE_URL)%'
加 default: 更稳妥，例如：'%env(default:sqlite:///%kernel.project_dir%/var/data.db:DATABASE_URL)%'