原文：the symfony Reference Book, http://www.symfony-project.org/reference/1_2/en/02-YAML
翻译：ELEME Dev Team
大多数的symfony配置文件使用YAML格式。YAML 官方网站称 YAML 是“一种所有编程语言可用的友好的数据序列化标准”。
YAML 是一种轻量化的数据描述语言。类似于 PHP, YAML一样具有轻量化的语法与数据类型，如字符串、布尔型、浮点型或整数型等。但不同于PHP的是，它区分数组（序列）和散列表（哈希表） 。
尽管 YAML 格式能够描述更为复杂的嵌套的数据结构，本节仅描述你在 symfony 中使用 YAML 作为配置文件所需要了解的 YAML 最小功能集。
YAML 基础类型语法与PHP中的相似。
字符串
A string in YAML
'A singled-quoted string in YAML'
在一个单引号标注的字符串中，一个单引号'必须用另一个单引号进行转义：
'A single quote '' in a single-quoted string'
"A double-quoted string in YAML\n"
当一个字符串前后包含空格时，必须使用引号标注的格式。
双引号标注的风格提供了一种使用转义符号\表达任意字符串的方式。当您需要嵌入一个\n或Unicode字符的时候，这是非常有用的。
当一个字符串包含换行符，您可以通过使用|符号表明该字符串将跨越数行，从而使用传统的文本风格。在这种格式下，换行符将不被转义：
|
\/ /| |\/| |
/ / | | | |__
或者，字符串可以通过>符号写成这样的折叠式，这样每一个换行符都将被替换成空格：
>
This is a very long sentence
that spans several lines in the YAML
but which will be rendered as a string
without carriage returns.
请注意：在上面这个例子中，每一行前的两个空格将不会出现在结果的PHP字符串中。
数字
# 整数
12
# 八进制整数
014
＃十六进制整数
0xC
＃浮点数
13.4
＃指数
1.2e+34
＃无穷大
.inf
空值
在YAML中，空值可以用null或~ 表示。
布尔值
在YAML中，布尔值用true和false 表示。
尽管 symfony 的 YAML解析器能够把on 、 off 、 yes和no 等解析为布尔值，但是我们强烈反对使用他们，因为它们已经在YAML 1.2标准中被移除。
日期
YAML 使用 ISO-8601 标准表示日期：
2001-12-14t21:59:43.10-05:00
＃简单日期示例
2002-12-14
集合
YAML文件很少仅用来描述一个简单的基础类型。大多数时候，它被用来描述一个集合。一个集合可以是一个序列（数组）或散列表（哈希表）。序列和散列表都会被转换成为 PHP 的数组。
使用一个跟着空格的“-”符号来声明一个序列：
- PHP
- Perl
- Python
这相当于下面的PHP代码：
array('PHP', 'Perl', 'Python');
使用一个跟着空格的冒号标记每一个键/值对来声明一个散列表：
PHP: 5.2
MySQL: 5.1
Apache: 2.2.20
这相当于下面的PHP代码：
array('PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20');
在散列表中，键 (key) 可以是任何合法的YAML基础类型。
一个散列项的冒号和值之间必须至少有一个或者更多个空格，而具体的空格数目并不重要：
PHP: 5.2
MySQL: 5.1
Apache: 2.2.20
YAML使用一个或多个空格的缩进来描述嵌套集合：
"symfony 1.0":
PHP: 5.0
Propel: 1.2
"symfony 1.2":
PHP: 5.2
Propel: 1.3
这段 YAML 代码相当于下面的PHP代码：
array(
'symfony 1.0' => array(
'PHP' => 5.0,
'Propel' => 1.2,
),
'symfony 1.2' => array(
'PHP' => 5.2,
'Propel' => 1.3,
),
);
在YAML文件中使用缩进时必须牢记的一件事情是： 必须使用一个或多个空格进行缩进，而不能使用制表符 (Tab键) 。
你可以像这样混合使用嵌套的序列和散列表：
'Chapter 1':
- Introduction
- Event Types
'Chapter 2':
- Introduction
- Helpers
YAML也可以使用流风格的集合，使用明确的标示符而不是缩进进行集合范围的界定。
一个序列可以写成方括号（ [] ） 中逗号分隔的列表的形式：
[PHP, Perl, Python]
一个散列表可以写成大括号（ {} ） 中逗号分隔的键/值对列表的形式：
{ PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 }
你也可以混合两种风格，以实现更好的可读性：
'Chapter 1': [Introduction, Event Types]
'Chapter 2': [Introduction, Helpers]
"symfony 1.0": { PHP: 5.0, Propel: 1.2 }
"symfony 1.2": { PHP: 5.2, Propel: 1.3 }
注释
YAML 中添加注释的方式是通过井字符（#）：
＃行末评论
"symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comment at the end of a line
"symfony 1.2": { PHP: 5.2, Propel: 1.3 }
由于注释会被YAML解析器忽略，因此不必刻意对注释进行缩进。
动态 YAML 文件
在 symfony 中，一个 YAML 文件可以包含 PHP 代码，这部分代码将在 YAML 文件解析前被执行：
1.0:
version: <?php echo file_get_contents('1.0/VERSION')."\n" ?>
1.1:
version: "<?php echo file_get_contents('1.1/VERSION') ?>"
注意保持文件的正确缩进格式。当在 YAML 中嵌入 PHP 代码时，应记住以下几点：
<?php ?> 语句必须在一行的开始，或作为一个属性的值的一部分- 若
<?php ?>在行末，则需要在 php 中输出一个换行符（”\n”）。
一个完整的例子
下面的例子使用了本章中提到的 YAML 语法：
"symfony 1.0":
end_of_maintainance: 2010-01-01
is_stable: true
release_manager: "Gregoire Hubert"
description: >
This stable version is the right choice for projects
that need to be maintained for a long period of time.
latest_beta: ~
latest_minor: 1.0.20
supported_orms: [Propel]
archives: { source: [zip, tgz], sandbox: [zip, tgz] }
"symfony 1.2":
end_of_maintainance: 2008-11-01
is_stable: true
release_manager: 'Fabian Lange'
description: >
This stable version is the right choice
if you start a new project today.
latest_beta: null
latest_minor: 1.2.5
supported_orms:
- Propel
- Doctrine
archives:
source:
- zip
- tgz
sandbox:
- zip
- tgz
