Swagger註釋中可選的路徑參數

Question

我正在使用此library。我想在我的網址的可選參數

比如我有這條路線

$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和與this plugin我可以用我的文檔做捲曲。 如果我選擇用0值我所有的捲髮像

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

我想有一個像

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

Answer 1

捲曲最近有招搖UI（與v3.0.0版）的改寫，在您的代碼按預期工作。 所以這可能是Chrome擴展使用v2.2.8版本中的一個錯誤。

由於swagger ui只是html和js，因此您可以簡單地使用download a recent version of the swagger-ui並使用此擴展名代替擴展名。