Api Platform+Symfony为列表和单条查询定义不同序列化组

你现在的配置和需求完全反向，且序列化组配置范围错误：

• 你期望单条详情接口返回更丰富的字段，但你给itemOperations下的get操作单独配置的序列化组仅包含control:read，自然不会加载fullcontrol:read对应的字段
• 你没有给列表查询的collectionOperations单独配置序列化组，列表接口反而会继承全局的fullcontrol:read组，和你的预期完全相反

调整两个操作的序列化组配置即可：

1. 给列表查询的collectionOperations单独配置normalizationContext，仅使用control:read组，保证列表返回少量字段
2. 给单条详情的itemOperations配置序列化组同时包含control:read和fullcontrol:read，既保留基础字段，也能返回额外的全量字段

修正后的注解配置如下：

/**
 * @ApiResource(
 *     formats={"json"},
 *     forceEager=false,
 *     collectionOperations={
 *      "get"={
 *          "normalizationContext"={
 *              "groups"={"control:read"}
 *          }
 *      }
 *     },
 *     itemOperations={
 *      "get"={
 *          "normalizationContext"={
 *              "groups"={"control:read", "fullcontrol:read"},
 *              "enable_max_depth"=true
 *          }
 *      }
 *     }
 * )
 * @ORM\Entity(repositoryClass=ControlRepository::class)
 */
class Control
{
    // 原有属性和注解无需修改
}

如果你不想同时写两个组，也可以直接把所有需要在详情返回的字段都加上@Groups({"fullcontrol:read"})注解，然后详情操作只配置fullcontrol:read一个组即可。

配置修改后执行php bin/console cache:clear清除Symfony缓存，再调用接口即可看到效果：

• GET /controls 仅返回id、appointments字段
• GET /controls/{id} 会额外返回objectEntity字段

内容的提问来源于stack exchange，提问作者Drakyn_