YAML格式
编辑该页面警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 2.5,不再维护。
读这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。
YAML格式
根据官方YAMLYAML的网站是“人类友好的数据序列化所有编程语言标准”。
即使YAML格式可以描述复杂的嵌套数据结构,本章只描述了最低的一组特征作为配置文件需要使用YAML格式。
YAML是一个简单的语言来描述数据。PHP,它有一个语法简单类型,如字符串、布尔值、花车、或整数。但与PHP,这使得不同的数组(序列)和散列(映射)。
标量
标量的语法类似于PHP的语法。
字符串
YAML的字符串可以包裹在单引号和双引号。在某些情况下,他们也可以非挂牌:
1 2 3 4 5
一个字符串在YAML“YAML singled-quoted字符串”“一个双引号字符串YAML”引用样式非常有用当一个字符串开始或结束与一个或多个相关的空间,因为非上市字符串解析其内容时都修剪。报价时需要字符串包含特殊或保留字符。
使用单引号的字符串时,任何单引号”在其内容必须翻了一番,达到逃避:
1
'单引号'在使用单引号的字符串的字符串包含下列字符必须引用。虽然您可以使用双引号,这些角色更方便使用单引号,避免不得不逃避任何反斜杠\:
:,{,},(,],,,&,*,#,吗?,|,- - - - - -,<,>,=,!,%,@,\ '
双引号风格提供了一种方式来表达任意字符串,通过使用\转义字符序列。例如,它是非常有用的,当你需要嵌入\ n或一个Unicode字符的字符串。
1
“一个双引号字符串YAML \ n”如果字符串包含下列控制字符,它必须与双引号转义:
\ 0,\ x01,\ x02,\ x03,\ x04,\ x05,\ x06,、一个,\ b,\ t,\ n,v \,\ f,r \,\ x0e,\ x0f,\ x10,\ x11,\ x12,\ * 13,\ x14英寸,\连接,\ x16,\ x17,\ x18,\ x19,\ x1a,\ e,\ x1c,\ x1d,\ x1e,\ x1f,\ N,\ _,L \,\ P
最后,还有其他情况必须引用的字符串,无论如果你使用单引号或双引号:
- 当字符串
真正的或假(否则,它将被视为一个布尔值); - 当字符串
零或~(否则,它将被视为一个零值); - 当字符串看起来像一个数字,比如整数(如。
2,14等),浮动(如。2.6,14.9(如)和指数数字。12 e7等)(否则,它将被视为一个数值); - 看起来像一个日期(如当字符串。
2014-12-31)(否则它会自动转换成一个Unix时间戳)。
当一个字符串包含换行符,您可以使用文字风格,表示由管道(|),表明该字符串将跨越几行。在文字换行保存:
1 2 3
| \ / / | | \ / | | / / | | | | __另外,字符串可以用折叠的风格,用>每个换行,取而代之的是一个空间:
1 2 3 4 5
>这是一个很长的句子,跨越几行YAML但没有回车将呈现为一个字符串。请注意
注意前两个空间的每一行前面的例子。他们不会出现在结果PHP字符串。
零位
在YAML可以表示null零或~。
布尔值
布尔值在YAML表达真正的和假。
集合
YAML文件很少被用来描述一个简单的标量。大多数时候,它描述了一个集合。可以是一个序列或一个映射集合的元素。序列和映射都转换为PHP数组。
序列使用破折号,后跟一个空间:
1 2 3
- - - - - -PHP- - - - - -Perl- - - - - -Python前面的YAML文件相当于以下PHP代码:
1
数组(“PHP”,“Perl”,“巨蟒”);映射使用冒号后面跟着一个空间(:)为了纪念每一个键/值对:
1 2 3
PHP:5.2MySQL:5.1Apache:2.2.20相当于这个PHP代码:
1
数组(“PHP”= >5.2,“MySQL”= >5.1,“阿帕奇”= >“2.2.20”);请注意
在一个映射,一个关键的可以是任何有效的标量。
结肠之间空格的数量和价值并不重要:
1 2 3
PHP:5.2MySQL:5.1Apache:2.2.20YAML使用缩进与一个或多个空间来描述嵌套的集合:
1 2 3 4 5 6
“ob娱乐下载symfony 1.0”:PHP:5.0推动:1.2“ob娱乐下载symfony 1.2”:PHP:5.2推动:1.3下面的YAML相当于以下PHP代码:
1 2 3 4 5 6 7 8 9 10
数组(“ob娱乐下载symfony 1.0”= >数组(“PHP”= >5.0,“推动”= >1.2),“ob娱乐下载symfony 1.2”= >数组(“PHP”= >5.2,“推动”= >1.3),);有一个重要的事情你需要记住当使用缩进在YAML文件:缩进必须与一个或多个空格,但从未与表格。
您可以嵌套序列和映射:
1 2 3 4 5 6
“第一章”:- - - - - -介绍- - - - - -事件类型“第二章”:- - - - - -介绍- - - - - -助手YAML还可以使用流风格的集合,使用显式的指标而不是缩进表示范围。
一个序列可以写成,在方括号(逗号分隔的列表[]):
1
(PHP,Perl,Python)映射可以写成一个逗号分隔的列表在花括号键/值({}):
1
{PHP:5.2,MySQL:5.1,Apache:2.2.20}你可以混合和匹配样式来实现更好的可读性:
1 2
“第一章”:(介绍,事件类型)“第二章”:(介绍,助手)1 2
“ob娱乐下载symfony 1.0”:{PHP:5.0,推动:1.2}“ob娱乐下载symfony 1.2”:{PHP:5.2,推动:1.3}评论
可以添加评论在YAML加上前缀散列马克(#):
1 2 3
#评论一条线“ob娱乐下载symfony 1.0”:{PHP:5.0,推动:1.2}#注释的行“ob娱乐下载symfony 1.2”:{PHP:5.2,推动:1.3}请注意
评论只是忽视YAML解析器和不需要根据当前的嵌套层次缩进一个集合。
