YAML格式
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.4,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
YAML格式
据这位官员说YAML在网站上,YAML是“适用于所有编程语言的人类友好的数据序列化标准”。
即使YAML格式可以描述复杂的嵌套数据结构,本章也只描述了使用YAML作为配置文件格式所需的最小特性集。
YAML是一种描述数据的简单语言。作为PHP,它有用于简单类型(如字符串、布尔值、浮点数或整数)的语法。但与PHP不同的是,它区分了数组(序列)和哈希(映射)。
标量
标量的语法类似于PHP语法。
字符串
1
一个字符串在YAML
1
YAML中的单引号字符串
提示
在单引号字符串中,一个单引号'
必须加倍:
1
“单引号”'单引号字符串'
1
" YAML\n中的双引号字符串"
当字符串以一个或多个相关空格开始或结束时,引用样式非常有用。
提示
双引号样式提供了一种表达任意字符串的方法,使用\
转义序列。在需要嵌入对象时,它非常有用\ n
或者字符串中的unicode字符。
当字符串包含换行符时,可以使用由管道(|
),表示该字符串将跨越几行。在字面量中,换行符被保留:
1 2 3
|\/ /| |\/| | / /| | | |__
字符串也可以用折叠样式来写,表示为>
,其中每个换行符都被空格取代:
1 2 3 4 5
>这是一个非常长的句子,在YAML中跨越了几行,但它将被呈现为一个不带回车符的字符串。
请注意
注意前面例子中每行前的两个空格。它们不会出现在结果的PHP字符串中。
零位
YAML中的空值可以用零
或~
.
布尔值
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.20
YAML使用缩进和一个或多个空格来描述嵌套集合:
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解析器简单地忽略,并且不需要根据集合中嵌套的当前级别缩进。