参数必须在services.yaml的parameters:块中显式声明且缩进正确，引用时用%param_name%语法，仅限服务定义中使用，环境变量需通过%env(type:VAR)%桥接并配合.cache:clear清理缓存。
参数必须先声明再引用，否则容器编译直接报错 The parameter "xxx" does not exist；声明位置在 config/services.yaml 的 parameters: 区块，不是随便写个键名就能用。
parameters 必须定义在 services.yaml 的 parameters: 下
所有自定义参数都要显式列在 parameters: 块里，YAML 缩进必须对齐（用空格，不能 Tab），冒号后必须跟一个空格：
parameters:
app.upload_path: '%kernel.project_dir%/public/uploads'
app.api_timeout: 30
app.allowed_types: ['image/jpeg', 'image/png']
- 路径类参数优先用 Symfony 内置参数拼接，比如
%kernel.project_dir%，别写__DIR__或绝对路径 - 数组、布尔、整数等类型可直接写，YAML 会自动识别，不用加引号（但含特殊字符的字符串建议用单引号包裹）
- 参数名里不能有大写字母或特殊符号，推荐小写下划线风格，如
app_cache_ttl，避免APP_CACHE_TTL或app-cache-ttl
引用参数要用 %parameter_name% 语法，且只能在服务定义中用
参数本身是静态值，只在服务构造函数里接收，不能在控制器或模板里直接写 %app.upload_path% —— 那样只是字面量字符串，不会被解析：
services:
App\Service\FileUploader:
class: App\Service\FileUploader
arguments:
- '%app.upload_path%'
- '%app.api_timeout%'
- 构造函数签名必须严格匹配：顺序、类型、数量都要一致，
public function __construct(string $path, int $timeout) - 如果参数是数组，构造函数对应参数得声明为
array $allowedTypes，PHP 8+ 可用array类型，别写string[]（那是 PHPDoc 注解） - 不要把
@service_id和%parameter_name%混用，比如'%logger%'是错的，logger 是服务，该写'@logger'
环境变量要通过 %env() 语法桥接，不能直接塞进 parameters 块
parameters: 块里不支持直接写 %env(APP_TIMEOUT)% —— 这会被当字符串字面量。正确做法是让参数值“间接”来自环境变量：
parameters:
app.api_timeout: '%env(int:APP_TIMEOUT)%'
然后在 .env 里写：
APP_TIMEOUT=60
-
int:、bool:、json:等前缀用于类型转换，没前缀默认是字符串 - 部署时若缓存未更新，
%env()%值可能卡在旧版本，务必执行bin/console cache:clear --env=prod && bin/console cache:warmup --env=prod - 别在
parameters.yaml里写database_url: '%env(DATABASE_URL)%'—— 正确位置是config/packages/doctrine.yaml中的url: '%env(resolve:DATABASE_URL)%'，resolve:才触发解析
不同环境的参数差异，靠 services_{env}.yaml + .env.{env} 实现
Symfony 不会自动加载 parameters_dev.yaml，所谓“按环境区分”，实际是靠文件名约定 + 显式 imports：
- 推荐做法：直接在
config/services_dev.yaml里重写parameters:块，覆盖开发环境值 - 如果坚持拆文件，必须在
config/services_dev.yaml里手动imports: [{ resource: 'parameters_dev.yaml' }]，且确保该文件存在、没被.gitignore掉 -
parameters.yaml是全局加载的，里面定义的参数无法被环境文件覆盖 —— 想覆盖就得用%env()%表达式 +.env.local或.env.prod分环境控制
最易忽略的一点：参数名拼错、缩进错位、.env 文件未加载、缓存未清——这四类问题占了参数不生效的 90%，别急着查代码逻辑，先盯住这四个地方。
