Yaml组件

编辑本页

警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 2.7,现已不再维护。

本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。

Yaml组件

Yaml组件加载和转储Yaml文件。

这是什么?

Symf欧宝娱乐app下载地址ony Yaml组件解析Yaml字符串,将其转换为PHP数组。它还能够将PHP数组转换为YAML字符串。

YAMLYAML不是标记语言,是适用于所有编程语言的人类友好的数据序列化标准。YAML是配置文件的一种很好的格式。YAML文件和XML文件一样具有表现力,和INI文件一样具有可读性。

Symf欧宝娱乐app下载地址ony Yaml组件实现了定义在YAML 1.2版本规范

提示

中了解有关Yaml组件的更多信息YAML格式篇文章。

安装

1
作曲家需要symfony/yaml欧宝娱乐app下载地址

或者,您可以克隆https://github.com/欧宝娱乐app下载地址symfony/yaml存储库。

请注意

如果在Symfony应用程序外部安装此组件,则必须要求欧宝娱乐app下载地址供应商/ autoload.php文件,以启用Composer提供的类自动加载机制。读这篇文章欲知详情。

为什么?

Symfony Yaml的目标之一是在速欧宝娱乐app下载地址度和功能之间找到正确的平衡。它只支持处理配置文件所需的特性。值得注意的是:文档指令、多行引用消息、紧凑块集合和多文档文件。

真正的解析器

它展示了一个真正的解析器,能够解析YAML规范的一个大子集,以满足您的所有配置需求。这还意味着该解析器非常健壮,易于理解,并且易于扩展。

清除错误消息

每当您的YAML文件出现语法问题时,库都会输出一条有用的消息,其中包含发生问题的文件名和行号。它大大简化了调试。

转储文件支持

它还能够在对象支持下将PHP数组转储到YAML,并提供内联级配置以获得漂亮的输出。

类型支持

它支持大多数YAML内置类型,如日期、整数、八进制、布尔值等等……

完全合并键支持

完全支持引用、别名和完整的合并键。不要重复引用常用配置位。

使用Symfony 欧宝娱乐app下载地址YAML组件

Symf欧宝娱乐app下载地址ony Yaml组件非常简单,由两个主要类组成:一个解析Yaml字符串(解析器),另一个将PHP数组转储到YAML字符串(自动倾卸车).

在这两个类之上,是Yaml类充当简化常用用途的薄包装器。

读取YAML文件

parse ()方法解析YAML字符串并将其转换为PHP数组:

1 2 3
使用欧宝娱乐app下载地址组件YamlYaml价值= Yaml::解析函数(“/道路/ / file.yml”));

谨慎

因为目前可以向此方法传递文件名,所以必须首先验证输入。传递文件名在Symfony 2.2中已弃用,在Symfony 3.0中已欧宝娱乐app下载地址被移除。

如果在解析期间发生错误,解析器将抛出抛出ParseExceptionexception指示错误类型和原始YAML字符串中错误发生的行:

1 2 3 4 5 6 7
使用欧宝娱乐app下载地址组件Yaml异常抛出ParseException试一试价值= Yaml::解析函数(“/道路/ / file.yml”));}(ParseException异常) {printf("无法解析YAML字符串:%s"异常->getMessage ());}

映射对象

2.7

支持将映射解析为对象是在Symfony 2.7中引入的。欧宝娱乐app下载地址

Yaml映射基本上都是关联数组。您可以指示解析器将映射作为对象返回(例如:\ stdClass实例)通过将第四个参数设置为真正的

1 2 3
对象= Yaml::解析(”{“foo”:“酒吧”}’真正的);回声get_class (对象);/ / stdClass回声对象->foo;/ /酒吧

编写YAML文件

dump ()方法将任何PHP数组转储到它的YAML表示:

1 2 3 4 5 6 7 8 9 10
使用欧宝娱乐app下载地址组件YamlYaml数组数组“foo”= >“酒吧”“酒吧”= >数组“foo”= >“酒吧”“酒吧”= >“记者”),);yaml= Yaml::转储(数组);写入“/道路/ / file.yml”yaml);

如果在转储期间发生错误,解析器将抛出DumpException例外。

数组扩展和内联

YAML格式支持两种数组表示形式:扩展数组和内联数组。默认情况下,转储器使用扩展表示:

1 2 3 4
foo:酒吧栏:foo:酒吧栏:巴兹

的第二个参数dump ()方法自定义输出从展开表示切换到内联表示的级别:

1
回声Yaml::转储(数组1);
1 2
foo:酒吧栏:foo:酒吧,栏:巴兹
1
回声Yaml::转储(数组2);
1 2 3 4
foo:酒吧栏:foo:酒吧栏:巴兹

缩进

默认情况下,YAML组件将使用4个空格作为缩进。这可以使用第三个参数进行更改,如下所示:

1 2
//使用8个空格缩进回声Yaml::转储(数组28);
1 2 3 4
foo:酒吧栏:foo:酒吧栏:巴兹

无效类型和对象序列化

默认情况下,YAML组件将任何“不受支持的”类型(即资源和对象)编码为

而不是编码为如果在转储器或解析器中遇到无效类型,您可以选择抛出异常,如下所示:

1 2 3 4 5
//如果遇到资源或对象,则抛出异常Yaml::转储(数据24真正的);//如果在YAML字符串中找到已编码的对象,则抛出异常Yaml::解析(yaml真正的);

然而,你可以使用下一个参数激活对象支持:

1 2 3 4 5 6 7 8 9
对象\ stdClass ();对象->foo =“酒吧”倾倒= Yaml::转储(对象24真正的);/ / ! ! php /对象:O: 8:“stdClass”:1:{:5:“foo”;销售:7:“酒吧”;}解析= Yaml::解析(倾倒真正的);var_dump (is_object (解析));/ /正确的回声解析->foo;/ /酒吧

YAML组件使用PHP的serialize ()方法生成对象的字符串表示形式。

谨慎

对象序列化是特定于此实现的,其他PHP YAML解析器可能无法识别php /对象标签和非php实现当然不会——谨慎使用!

此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。