Symfony配置文件主要用YAML格式，核心是键值对、缩进层级和类型识别；关键要点包括：缩进必须用空格且冒号后需空格，%引用参数、@引用服务，YAML不支持XML内联工厂须拆分为独立服务再引用，推荐用imports模块化管理配置。
Symfony 配置文件主要用 YAML 格式书写，结构清晰、缩进敏感、语义明确。它不是自由文本，而是有严格语法约束的配置描述语言，核心在于“键值对 + 缩进层级 + 类型识别”。写对的关键不在于记住所有规则，而在于理解几个高频、易错的要点。
基础语法：缩进和冒号是命门
YAML 不用花括号或分号，靠空格缩进来表达嵌套关系。同一层级的键必须左对齐，缩进必须用空格（不能用 Tab）。冒号后必须跟一个空格，再写值。
-
正确：
database_url: 'mysql://root:@127.0.0.1:3306/myapp' -
错误：
database_url:'mysql://root:@127.0.0.1:3306/myapp'（冒号后没空格） -
错误：
database_url: '...'（开头多两个空格，可能被误判为子项）
参数与引用：用 % 和 @ 区分两类变量
Symfony YAML 中有两种常用占位符：
-
%parameter_name%：引用参数（如环境变量、
parameters.yaml里定义的值），类型是字符串、布尔、数字等基础类型 - @service_id：引用容器中已注册的服务对象，类型是类实例，不是数组或字符串
- 混淆这两者会导致构造函数类型错误，比如把
@filesystem写成%filesystem%，服务就收不到对象，只收到字符串
工厂服务：YAML 不支持 XML 那种内联写法
XML 可以这样写工厂：
<service class="App\Service">
<service class="Gaufrette\Filesystem">
<factory service="filesystem_map" method="get"/>
</service>
</service>
但 YAML 不能嵌套 service 定义。你不能写：
arguments:- { class: ..., factory: ... } <-- 这会被当成数组，不是服务
正确做法是拆开：先定义工厂服务，再在目标服务中引用它：
filesystem_service:class: Gaufrette\Filesystem
factory: ['@knp_gaufrette.filesystem_map', 'get']
arguments: ['default']
my_service_id:
class: App\Some\Service
arguments: ['@filesystem_service']
导入与模块化：用 imports 拆分大配置
避免把所有路由、服务、日志塞进一个文件。用 imports 分层管理：
- 主配置
config/packages/framework.yaml可以 import 其他文件 - 写法统一为：
imports: [ { resource: 'services_api.yaml' } ] - 导入路径是相对于当前文件位置的，推荐用相对路径 + 明确后缀，避免歧义
- 路由配置常按功能拆到
config/routes/下，再统一 import
