symfony 中没有“规范化器”，实际应使用 serializer 组件：它通过归一化、编码/解码三步实现对象与 json/xml 的双向转换，并支持序列化组、多格式响应等特性。
Symfony 中没有叫“规范化器”的内置组件，你实际想用的，是 Serializer（序列化器）——它负责把 PHP 对象转成 JSON/XML 等标准格式（序列化），也负责把请求数据还原为对象（反序列化）。所谓“规范化响应”，本质就是统一、可控、可扩展地输出结构化数据，这正是 Serializer 的核心职责。
Serializer 是怎么工作的？
它不是简单 json_encode()，而是分三步走：
- Normalization（归一化）：把对象/数组转成纯 PHP 数组（去掉方法、资源、循环引用等）
- Encoding（编码）：把归一化后的数组转成字符串（如 JSON 字符串）
- Decoding & Denormalization（解码与还原）：把请求体字符串解析成数组，再映射到对象或 DTO
框架默认启用 json 编码器和 object 归一化器，开箱即用。
基础配置：确保 Serializer 已启用
检查 config/packages/framework.yaml：
framework:
serializer:
enabled: true
# 可选：启用注解支持（如 @Groups）
enable_annotations: true
不需要额外安装（Symfony 6+ 默认包含），但若要用 XML，需加包：
composer require symfony/xml-serializer
控制器中规范输出响应
✅ 推荐写法（自动处理 Content-Type、状态码、序列化组）：
use Symfony\Component\HttpFoundation\Response;
#[Route('/api/users/{id}', name: 'api_user_get', methods: ['GET'])]
public function getUser(User $user): Response
{
return $this->json($user, Response::HTTP_OK, [], [
'groups' => ['user:read']
]);
}
$this->json() 底层调用 Serializer，并自动设置 Content-Type: application/json。
⚠️ 不推荐手动 json_encode() + new Response()，会丢失组控制、上下文、错误处理等能力。
用序列化组控制字段输出
在实体类中加注解：
// src/Entity/User.php
use Symfony\Component\Serializer\Annotation\Groups;
class User
{
#[Groups(['user:read', 'user:write'])]
private string $username;
#[Groups(['user:read'])]
private ?string $email = null;
#[Groups(['admin:full'])]
private array $roles = [];
}
调用时指定组，就能精准控制哪些字段出现：
$json = $serializer->serialize($user, 'json', ['groups' => ['user:read']]);
支持多格式响应（JSON / XML / HTML）
启用格式侦听器后，客户端可通过 Accept 头自动切换：
# config/packages/framework.yaml
framework:
format_listener: true
default_format: json
request:
formats:
json: ['application/json', 'application/*+json']
xml: ['application/xml', 'text/xml']
html: ['text/html']
控制器返回原始数据，框架自动选格式：
public function list(): Response
{
$users = $this->userRepository->findAll();
// 返回数组或对象，Serializer 自动按 Accept 头决定是 JSON 还是 XML
return $this->render('api/users.'.$this->getRequest()->getRequestFormat(), [
'users' => $users,
]);
}
注意：XML 需额外配置 encoder 和 normalizer，且实体要兼容（比如用
@SerializedName或@XmlRoot注解）。
不复杂但容易忽略
