下面由laravel教程欄目給大家介紹在laravel中使用apidoc的方法,希望對需要的朋友有所幫助!
apidoc官方文檔:http://apidocjs.com/#params
第一步:使用:npm install apidoc -g
命令安裝apidoc。
第二步:在項目根目錄下新建apidoc.json文件,文件內容格式參考如下:
{ ??"name":?"laravel5?API文檔", ??"version":?"v1.0", ??"description":?"本文檔提供laravel5?商品,訂單,收貨地址,等API文檔供嗨聊服務端開發人員作為參考,文檔使用RESTfull風格,如有疑問請聯系開發者", ??"apidoc":?{ ????"title":?"laravel5?API文檔", ????"url"?:?"http://http://www.learnlaravel5.com//api" ??}}
如圖:
第三步:使用apidoc -i myapp/ -o apidoc/ -t mytemplate/”
其中: -i?表示輸入,后面是文件夾路徑-o?表示輸出,后面是文件夾路徑默認會帶上-c,在當前路徑下尋找配置文件(apidoc.json),如果找不到則會在package.json中尋找?"apidoc":?{?} myapp/?表示要生成api的源文檔所在目錄位置 mytemplete/?表示要生成api到的目錄位置
如:我要將app/Http/Controllers/Api/目錄下的文檔生成api文件到public/api的命令如下:
apidoc?-i?app/Http/Controllers/Api/?-o?public/api
如圖:
目錄結構如圖:
? 版權聲明
文章版權歸作者所有,未經允許請勿轉載。
THE END
喜歡就支持一下吧
相關推薦