Как использовать аннотации Swagger/OpenAPI в PHP для описания файла cookie?

Согласно документации OpenAPI, когда вы хотите описать файл cookie, отправленный с ответом, вы должны описать его через заголовок Set-Cookie.

Затем вы можете реализовать это с помощью аннотаций OA:

    /**
     * @OA\Get(
     *     path = "/api/users",
     *     summary = "...",
     *     @OA\Response(
     *        response = "200",
     *        description = "...",
     *        @OA\Header(
     *            header = "Set-Cookie",
     *            @OA\Schema(
     *                  type = "string",
     *                  example = "Some value"
     *            )
     *        )
     *    )
     * )
     */

Вы должны переместить аннотацию @OA\Cookie на верхний уровень блока документации.

/**
 * @OA\Get(
 *     path = "/api/users",
 *     summary = "...",
 * )
 *
 * @OA\Cookie(
 *     name = "my_cookie",
 *     description = "...",
 *     @OA\Schema(
 *         type = "string"
 *     )
 * )
 */