php - 查询参数的 Swagger 注释

Question

我正在将 POST 请求转换为 GET 请求。我正在使用 NelmioApiDocBundle 来记录我的 API 端点。我目前有以下（旧）注释：

/**
 * @SWG\Response(
 *     response=200,
 *     description="Success - return JSON",
 * )
 * @SWG\Tag(name="Open Vacancies")
 *
 * @SWG\Parameter(
 *     name="Message body",
 *     in="body",
 *     type="string",
 *     description="JSON string specifying a page number and page size",
 *     required=true,
 *     @SWG\Schema(
 *         type="object",
 *         @SWG\Property(property="page", type="integer"),
 *         @SWG\Property(property="pageSize", type="integer")
 *     )
 * )
 *
 * @Route("/open-vacancies", methods={"POST"}, defaults={"_format": "json"}, name="api.open_vacancies")
 */

现在我希望开发人员能够使用https://myapi.myapp.com/open-vacancies?page=1&pageSize=10. 但我不知道如何以注释形式定义文档。谷歌对我帮助不大。有人可以指出我的相关文档（或者，如果失败，请输入我可以使用的注释示例）？

Answer 1

要记录查询参数，您也可以使用@SWG\Parameter注释，但您将值设置为intoquery而不是body

例子 ：

/**
 * @SWG\Parameter(
 *     name="pageSize",
 *     in="query",
 *     type="string",
 *     description="Description goes here"
 * )
 */