資料介紹
軟件簡介
基于 tp6 的 api 生成模塊,參考 fastadmin 的 api 模塊
引用
use jmwl\realapidoc\Builder; use think\facade\View;
使用
這里是所有的需要生成api的控制器路徑啦、所以,你可以先獲取到模塊下的所有控制器 Builder(["\app\admin\controller\Demo","\app\admin\controller\Index"])
$title="類名"; $url="http://real-think.jmwl51.com"; $lang=[ 'Info' => '基礎信息', 'Sandbox' => '在線測試', 'Sampleoutput' => '返回示例', 'Headers' => 'Headers', 'Parameters' => '參數(shù)', 'Body' => '正文', 'Name' => '名稱', 'Type' => '類型', 'Required' => '必選', 'Description' => '描述', 'Send' => '提交', 'Reset' => '重置', 'Tokentips' => 'Token在會員注冊或登錄后都會返回,WEB端同時存在于Cookie中', 'Apiurltips' => 'API接口URL', 'Savetips' => '點擊保存后Token和Api url都將保存在本地Localstorage中', 'Authorization' => '權限', 'NeedLogin' => '登錄', 'NeedRight' => '鑒權', 'ReturnHeaders' => '響應頭', 'ReturnParameters' => '返回參數(shù)', 'Response' => '響應輸出', ]; $config = [ 'sitename' => "測試", 'title' => $title, 'author' => "測試", 'description' => '', 'apiurl' => $url, 'language' => $lang, ]; //這里是所有的需要生成api的控制器路徑啦 $builder = new Builder(["\\app\\admin\\controller\\Demo","\\app\\admin\\controller\\Index"]); $content = $builder->render(root_path()."/extend/jmwl/realapidoc/template/index.html", ['config' => $config, 'lang' => $lang]); // dump($content); die; View::assign('config',$config); View::assign('docslist',$content["docsList"]); View::assign('lang',$content["lang"]); return View();
視圖
文件中的index.html就是視圖啦,放到正確的位置 我放在了 app\admin\view\api\index.html 對應的控制器自然是 admin下的api控制器啦
控制器注釋
名稱 | 描述 | 示例 |
---|---|---|
@ApiSector | API分組名稱 | (測試分組) |
@ApiRoute | API接口URL,此@ApiRoute只是基礎URL | (/api/test) |
@ApiInternal | 忽略的控制器,表示此控制將不加入API文檔 | 無 |
@ApiWeigh | API方法的排序,值越大越靠前 | (99) |
控制器方法注釋
名稱 | 描述 | 示例 |
---|---|---|
@ApiTitle | API接口的標題,為空時將自動匹配注釋的文本信息 | (測試標題) |
@ApiSummary | API接口描述 | (測試描述) |
@ApiRoute | API接口地址,為空時將自動計算請求地址 | (/api/test/index) |
@ApiMethod | API接口請求方法,默認為GET | (POST) |
@ApiSector | API分組,默認按鈕控制器或控制器的@ApiSector進行分組 | (測試分組) |
@ApiParams | API請求參數(shù),如果在@ApiRoute中有對應的{@參數(shù)名},將進行替換 | (, , required=true, ) |
@ApiHeaders | API請求傳遞的Headers信息 | (name=token, type=string, required=true, ) |
@ApiReturn | API返回的結果示例 | ({"code":1,"msg":"返回成功"}) |
@ApiReturnParams | API返回的結果參數(shù)介紹 | (, , required=true, ) |
@ApiReturnHeaders | API返回的Headers信息 | (, , required=true, ) |
@ApiInternal | 忽略的方法,表示此方法將不加入文檔 | 無 |
@ApiWeigh | API方法的排序,值越大越靠前 | (99) |
示范
namespace app\api\controller; /** * 測試API控制器 */ class Test extends \app\common\controller\Api { // 無需驗證登錄的方法 protected $noNeedLogin = ['test']; // 無需要判斷權限規(guī)則的方法 protected $noNeedRight = ['*']; /** * 首頁 * * 可以通過@ApiInternal忽略請求的方法 * @ApiInternal */ public function index() { return 'index'; } /** * 私有方法 * 私有的方法將不會出現(xiàn)在文檔列表 */ private function privatetest() { return 'private'; } /** * 測試方法 * * @ApiTitle (測試名稱) * @ApiSummary (測試描述信息) * @ApiSector (測試分組) * @ApiMethod (POST) * @ApiRoute (/api/test/test/id/{id}/name/{name}) * @ApiHeaders (name=token, type=string, required=true, ) * @ApiParams (, , required=true, ) * @ApiParams (, , required=true, ) * @ApiParams (, , , ) * @ApiReturnParams (, , required=true, ) * @ApiReturnParams (, , required=true, ) * @ApiReturnParams (, , , ) * @ApiReturn ({ 'code':'1', 'mesg':'返回成功' * }) */ public function test($id = '', $name = '') { $this->success("返回成功", $this->request->request()); } }
- 生成式AI對智能家居的影響 16次下載
- LabView工具包WebSocket-API主機下載 68次下載
- real-token基于tp6的權限驗證模塊
- 第6章:數(shù)字輸入/輸出模塊(I/O) 19次下載
- TP4100,TP4101,TP4102
- 愛華微膠囊記錄器TP-M725/TP-M525數(shù)據(jù)手冊 0次下載
- TP-LINK無線路由器升級軟件及說明 1次下載
- 16位CRC驗證碼生成VI工具下載 54次下載
- MPLAB REAL ICE在線仿真器功率監(jiān)視器開發(fā)工具的詳細中文資料概述
- MPLAB REAL ICE在線仿真器功率監(jiān)視器的介紹和使用指南詳細概述
- MPLAB REAL ICE 在線仿真器JTAG適配器的中文使用說明書
- Connecting_Real_People_with_Real_Solutions 5次下載
- iMX6_2D_API_Hardware_and_Platform_Independent_API_for_i.MX6_2D_Graphics 12次下載
- M25PE20-VMN6TP數(shù)據(jù)手冊 32次下載
- L2TP虛擬專用網(wǎng)
- 使用OpenVINO GenAI API的輕量級生成式AI 266次閱讀
- Kubernetes Gateway API攻略教程 676次閱讀
- N-API的JS堆對象生命周期管理 430次閱讀
- DDS信號生成模塊的Verilog實現(xiàn) 1146次閱讀
- 企業(yè)怎么選擇API網(wǎng)關 552次閱讀
- Katalon:API測試 840次閱讀
- 關于API接口相關知識 API的權限與安全問題 1591次閱讀
- 什么是API,不同場景中的API 2013次閱讀
- 基于使用TP-4056模塊制造鋰離子電池充電器設計 5787次閱讀
- 如何解決TP-Link路由器無線信號的問題 5084次閱讀
- 什么是API網(wǎng)關為什么需要API網(wǎng)關 1.2w次閱讀
- tp4055中文資料匯總(tp4055引腳圖功能_內部結構及應用電路) 2.8w次閱讀
- TP4056使用注意事項 5.1w次閱讀
- 如何使用API_api接口有什么優(yōu)點 2w次閱讀
- TP14管腳圖 3068次閱讀
下載排行
本周
- 1山景DSP芯片AP8248A2數(shù)據(jù)手冊
- 1.06 MB | 532次下載 | 免費
- 2RK3399完整板原理圖(支持平板,盒子VR)
- 3.28 MB | 339次下載 | 免費
- 3TC358743XBG評估板參考手冊
- 1.36 MB | 330次下載 | 免費
- 4DFM軟件使用教程
- 0.84 MB | 295次下載 | 免費
- 5元宇宙深度解析—未來的未來-風口還是泡沫
- 6.40 MB | 227次下載 | 免費
- 6迪文DGUS開發(fā)指南
- 31.67 MB | 194次下載 | 免費
- 7元宇宙底層硬件系列報告
- 13.42 MB | 182次下載 | 免費
- 8FP5207XR-G1中文應用手冊
- 1.09 MB | 178次下載 | 免費
本月
- 1OrCAD10.5下載OrCAD10.5中文版軟件
- 0.00 MB | 234315次下載 | 免費
- 2555集成電路應用800例(新編版)
- 0.00 MB | 33566次下載 | 免費
- 3接口電路圖大全
- 未知 | 30323次下載 | 免費
- 4開關電源設計實例指南
- 未知 | 21549次下載 | 免費
- 5電氣工程師手冊免費下載(新編第二版pdf電子書)
- 0.00 MB | 15349次下載 | 免費
- 6數(shù)字電路基礎pdf(下載)
- 未知 | 13750次下載 | 免費
- 7電子制作實例集錦 下載
- 未知 | 8113次下載 | 免費
- 8《LED驅動電路設計》 溫德爾著
- 0.00 MB | 6656次下載 | 免費
總榜
- 1matlab軟件下載入口
- 未知 | 935054次下載 | 免費
- 2protel99se軟件下載(可英文版轉中文版)
- 78.1 MB | 537798次下載 | 免費
- 3MATLAB 7.1 下載 (含軟件介紹)
- 未知 | 420027次下載 | 免費
- 4OrCAD10.5下載OrCAD10.5中文版軟件
- 0.00 MB | 234315次下載 | 免費
- 5Altium DXP2002下載入口
- 未知 | 233046次下載 | 免費
- 6電路仿真軟件multisim 10.0免費下載
- 340992 | 191187次下載 | 免費
- 7十天學會AVR單片機與C語言視頻教程 下載
- 158M | 183279次下載 | 免費
- 8proe5.0野火版下載(中文版免費下載)
- 未知 | 138040次下載 | 免費
評論
查看更多