symfony容器参数必须定义在config/services.yaml的parameters:区块下，不可放在其他配置文件或自命名yaml中；参数值需用内置变量如%kernel.project_dir%而非php常量；引用时严格使用'%param_name%'格式。
必须在 config/services.yaml 的 parameters: 区块下定义，不能写在 config/packages/*.yaml 里，也不能靠文件名自动加载。
parameters 必须写在 services.yaml 的 parameters: 下
Symfony 容器参数不是“随便放哪都行”的配置项。它只认 config/services.yaml（或通过 imports 显式引入的同级 YAML 文件）里的 parameters: 块。写错位置会导致容器编译失败或参数根本不可用。
- ✅ 正确位置：
config/services.yaml顶部或任意位置的parameters:下，例如：
parameters:
app.upload_path: '%kernel.project_dir%/public/uploads'
app.api_timeout: 30
app.locale: 'zh_CN'
- ❌ 错误做法：在
config/packages/framework.yaml或config/packages/doctrine.yaml里加parameters:—— 这些文件只管服务配置，不注册参数 - ❌ 不要新建
parameters_dev.yaml并指望它自动生效 —— Symfony 不会扫描或加载这种命名的文件，除非你在services_dev.yaml里手动imports
参数值里别直接写 PHP 常量或硬编码路径
参数值需保证跨环境可移植，不能依赖运行时 PHP 解析。否则部署到 Windows 或不同目录结构时会出错。
- ❌ 错误示例：
app.upload_path: __DIR__.'/../public/uploads'——__DIR__是 PHP 表达式，YAML 不识别，会被当字符串字面量 - ✅ 正确写法：
app.upload_path: '%kernel.project_dir%/public/uploads'——%kernel.project_dir%是 Symfony 内置参数，由容器在编译期展开 - ⚠️ 路径含反斜杠（Windows）时，务必用单引号包裹：
app.windows_path: '%kernel.project_dir%\public\uploads' - ✅ 环境变量要用
%env(resolve:VAR)%，不是%env(VAR)%—— 后者只是字面量，resolve:才触发实际读取
数组、布尔、数字类型直接写，不用额外包装
YAML 天然支持基础类型，parameters 区块里按原生语法写即可，Symfony 容器会原样保留类型。
- ✅ 字符串：
app.name: 'MyApp' - ✅ 数字：
app.api_timeout: 30（注意没引号，否则是字符串） - ✅ 布尔：
app.debug_mode: true - ✅ 数组：
app.allowed_types: ['image/jpeg', 'image/png'] - ⚠️ 混淆类型后果严重：比如把
app.api_timeout: '30'写成字符串，传给期待int的构造函数就会报TypeError
引用参数时必须用 %param_name%，且拼写零容错
参数名是容器的“键”，大小写、下划线、拼写差一个字符，运行时就抛 The parameter "xxx" does not exist。
- ✅ 引用方式严格限定为：
'%app.upload_path%'—— 百分号 + 参数名 + 百分号，单引号包裹（防 YAML 解析异常） - ❌ 不要漏百分号：
app.upload_path或'app.upload_path'都是字符串字面量，不是参数引用 - ❌ 不要和 service ID 混用：
@logger是服务对象，%logger%是字符串 —— 后者几乎总是错的 - ⚠️ 参数名本身不能含点号（
.）或空格，YAML 解析会失败；推荐用下划线分隔，如app_api_timeout而非app.api.timeout
最易被忽略的是参数作用域 —— parameters.yaml（如果存在）会被所有环境加载，但它里面定义的参数无法被 services_dev.yaml 覆盖。真要按环境区分，得用 %env()% + .env.local，而不是幻想改个文件名就能切换。
