Symfony 2.7.10构建REST API需依赖FOSRestBundle统一响应流程，手动配置序列化组、白名单校验查询参数，并通过异常映射确保JSON化错误响应与精准HTTP状态码。
Symfony 2.7.10 虽然版本较老，但仍在部分遗留系统中使用。开发 REST 接口时，它缺乏现代 Symfony 的自动序列化和 API 平台支持，因此更依赖手动控制与合理组合 FOSRestBundle、JMSSerializer（或原生 Serializer）、ViewHandler 等组件。关键不是升级框架，而是用好已有能力，规避常见陷阱。
用 FOSRestBundle 统一响应流程
FOSRestBundle 是 Symfony 2.7.x 时期构建 REST API 的事实标准。它能接管控制器返回值，自动协商格式（JSON/XML）、设置状态码、处理视图渲染——避免每个 action 都写 $this->json() 或手动 new JsonResponse。
- 确保在
app/config/config.yml中启用 bundle 和 view 模块：fos_rest:<br> view:<br> view_response_listener: 'force'
- 控制器方法返回
View对象（来自FOS\RestBundle\View\View），而非原始数组或 Response：use FOS\RestBundle\View\View;<br>public function getUsersAction() {<br> $users = $this->getDoctrine()->getRepository('AppBundle:User')->findAll();<br> return View::create($users, 200);<br>} - 这样可复用格式协商、异常转换（配合
exception配置）和序列化逻辑，比直接返回 JsonResponse 更易维护。
手动控制序列化字段，避免敏感数据泄漏
Symfony 2.7.10 默认不带 Groups 注解支持（那是 2.8+ 或 Serializer 组件独立配置后才完善的）。若用 JMSSerializer，需显式配置 exclusion policy 和 serialization groups；若用原生 Serializer（需手动启用），则必须通过 Context 设置 groups。
- 在实体类中用注解标注组：
use JMS\Serializer\Annotation as Serializer;<br>class User {<br> /** @Serializer\Groups({"list", "details"}) */<br> private $id;<br> /** @Serializer\Groups({"details"}) */<br> private $password;<br>} - 控制器中按场景传入 group：
$view = View::create($user)->setSerializationContext(<br> SerializationContext::create()->setGroups(['details'])<br>);
- 列表接口用
["list"]，详情接口用["details"]，密码等字段自然被排除。
分页、过滤、排序统一用 Query Param + 手动解析
2.7.10 没有 Doctrine ORM 的自动分页器（如 Pagerfanta 集成需额外配），也不支持现代的 ApiPlatform 查询参数自动绑定。所有查询参数都得手动提取、校验、拼进 DQL 或 QueryBuilder。
- 典型 URL：
GET /api/users?limit=10&offset=0&status=active&sort=name&order=asc - 在 controller 中：
$limit = $request->query->get('limit', 10);<br>$offset = $request->query->get('offset', 0);<br>$status = $request->query->get('status');<br>$qb = $repo->createQueryBuilder('u');<br>if ($status) { $qb->andWhere('u.status = :status')->setParameter('status', $status); }<br>$qb->setFirstResult($offset)->setMaxResults($limit); - 务必对
sort字段白名单校验（如只允许name,createdAt），防止 SQL 注入或非法字段排序。
错误响应必须 JSON 化且状态码精准
默认异常页面是 HTML，对 API 完全不可用。FOSRestBundle 提供 exception 配置，但 2.7.10 需搭配自定义异常控制器或全局 kernel.exception 监听器。
- 在
app/config/config.yml中配置：fos_rest:<br> exception:<br> codes:<br> Symfony\Component\HttpKernel\Exception\NotFoundHttpException: 404<br> Doctrine\ORM\NoResultException: 404<br> messages:<br> Symfony\Component\HttpKernel\Exception\BadRequestHttpException: true
- 再创建一个
ExceptionController，继承FOS\RestBundle\Controller\ExceptionController，重写showAction，确保返回纯 JSON：{"error": "Not Found", "code": 404} - 业务异常（如用户禁用、权限不足）应抛出对应 HTTP 异常，而不是返回 200 + error 字段 —— 前端靠状态码做网络层判断，不能依赖 body 解析。
