Параметры пути необязательны в аннотации Swagger

Question

Я использую эту библиотеку. Я хочу иметь необязательные параметры в моем URL

например у меня есть этот маршрут

$app->get('/files/{order:\d+}[/{all:0|1|all}]', 'myctroller');

И моя аннотация

/**
 * @SWG\Get(path="/doc/v1/files/{id_ordine}/{all}",
 *   tags={"GETFILE"},
 *   produces={"application/json"},
 *   @SWG\Parameter(
 *     name="order",
 *     in="path",
 *     type="integer",
 *     required=true,
 *     default="123",
 *   ),
 *   @SWG\Parameter(
 *     name="all",
 *     in="path",
 *     type="string",
 *     enum={"0","1","all"},
 *     default="all",
 *     required=false,
 *   ),
 *   @SWG\Response(response="200", description=xxx"),
 *   @SWG\Response(response="404", xxx")
 * )
 */

С Chrome и с этим плагином я могу сделать CURL с моей документацией. Если я выберу все со значением 0, мой локон будет как

http://localhost/doc/v1/files/123/{all}

Я хотел бы иметь CURL как

http://localhost/doc/v1/files/123

Answer 1

Недавно был переписан Swagger UI (с версией v3.0.0), в том, что ваш код работает, как ожидалось. Так что это, вероятно, ошибка в версии, которую использует расширение Chrome v2.2.8,

Поскольку пользовательский интерфейс Swagger - это только HTML и JS, вы можете просто загрузить последнюю версию пользовательского интерфейса Swagger и использовать ее вместо расширения.