如何使用序列化器
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 3.4，现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
如何使用序列化器
对对象和不同格式(例如JSON或XML)进行序列化和反序列化是一个非常复杂的主题。ob娱乐下载Symfony带有一个序列化器组件，它为您提供了一些可以用于解决方案的工具。
实际上，在开始之前，请通过阅读序列化器组件欧宝官网下载app文档。
激活序列化器
的序列化器默认情况下，该服务不可用。要打开它，请在配置中激活它:
- YAML
- XML
- PHP
1 2 3 4 5 6
# app / config / config.yml框架:#……序列化器:｛enable_annotations:真正的｝#或者，如果你不想使用注释#serializer: {enabled: true}使用序列化器服务
启用后，序列化器Service可以被注入到任何需要它的服务中，也可以在控制器中使用:
12 3 4 5 6 7 8 9 10 11 12 13
/ / src / AppBundle /控制器/ DefaultController.php名称空间AppBundle＼控制器；使用ob娱乐下载＼包＼FrameworkBundle＼控制器＼控制器；使用ob娱乐下载＼组件＼序列化器＼SerializerInterface；类DefaultController扩展控制器｛公共函数indexAction(SerializerInterface＄序列化器）｛//请继续阅读使用示例}}添加标准化器和编码器
启用后，序列化器服务将在容器中可用。它自带一套有用的编码器而且标准化者．
支持以下格式的编码器已启用:
- JSON:JsonEncoder
- XML:XmlEncoder
- CSV:CsvEncoder
- YAML:YamlEncoder
以及以下归一化器:
- ObjectNormalizer来处理典型的数据对象
- DateTimeNormalizer对于实现DateTimeInterface接口
- DateIntervalNormalizer为DateInterval对象
- DataUriNormalizer转换SplFileInfo对象数据uri
- JsonSerializableNormalizer处理实现JsonSerializable接口
- ArrayDenormalizer使用' MyObject[] '(注意'[]'后缀)这样的格式来反规范化对象数组
自定义规范化器和/或编码器也可以通过标记为来加载serializer.normalizer而且serializer.encoder．还可以设置标记的优先级以决定匹配顺序。
谨慎
总是要确保加载DateTimeNormalizer当序列化DateTime或DateTimeImmutable类，以避免过多的内存使用和暴露内部细节。
下面是一个关于如何加载GetSetMethodNormalizer，当数据对象总是使用getter时，' ObjectNormalizer '的一个更快的替代方案(getXxx ())， issers (isXxx ())或骚扰者(hasXxx ())读取属性和setter (setXxx ())以更改属性:
- YAML
- XML
- PHP
1 2 3 4 5 6
# app / config / services.yml服务:get_set_method_normalizer:类:ob娱乐下载Symfony \组件\ \标准化者\ GetSetMethodNormalizer进行序列化公众:假标签:(serializer.normalizer)3.4
对骚扰器方法的支持(hasXxx ())GetSetMethodNormalizer在Symfony 3.4中引入。ob娱乐下载在之前的Symfony版ob娱乐下载本中，只能获取(getXxx ())及issers (isXxx ())。
使用序列化组注释
启用序列化组注释配置如下:
- YAML
- XML
- PHP
1 2 3 4 5
# app / config / config.yml框架:#……序列化器:enable_annotations:真正的接下来，添加@Groups注释致您的班级:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
/ / src /实体/ Product.php名称空间应用程序＼实体；使用学说＼ORM＼映射作为ORM；使用ob娱乐下载＼组件＼序列化器＼注释＼组；/ * * *@ORM() * / \实体类产品｛/ * * *@ORM\ Id *@ORM\ GeneratedValue *@ORM\列(type =“整数”)*@Groups({"show_product"， "list_product"}) */私人＄id；/ * * *@ORM\列(type="string"， length=255) *@Groups({"show_product"， "list_product"}) */私人＄的名字；/ * * *@ORM\列(type =“整数”)*@Groups({}“show_product”)* /私人＄描述；｝你现在可以选择在序列化时使用哪些组:
1 2 3 4 5
＄json＝＄序列化器->序列化(＄产品，json的, (“组织”= >“show_product”]);除了@Groups注释，Serializer组件也支持Yaml或XML文件。当这些文件被存储在以下位置之一时，会自动加载:
- 的
serialization.yml或serialization.xml在资源/ config /包的目录; - 所有
* .yml而且* . xml文件资源/ config /序列化/包的目录。
启用元数据缓存
Serializer组件使用的元数据(例如组)可以被缓存以增强应用程序性能。默认情况下，序列化器使用cache.system缓存池cache.system选择。
启用名称转换器
使用名字转换器服务可以在配置中使用name_converter选择。
内置的CamelCase到snake_case名称转换器可以通过使用serializer.name_converter.camel_case_to_snake_case值:
- YAML
- XML
- PHP
1 2 3 4 5
# app / config / config.yml框架:#……序列化器:name_converter:“serializer.name_converter.camel_case_to_snake_case”进一步使用序列化器
ApiPlatform提供API系统支持JSON-LD而且Hydra核心词汇超媒体格式。它构建在Symfony Framework及其Serob娱乐下载ializer组件之上。它提供了自定义规范化器、自定义编码器、自定义元数据和缓存系统。
如果您想充分利用Symfony Serializer组件的全部功能，请看看这个包是如何工作的ob娱乐下载。
