安装/升级
2022年11月10日 14:34 指南 大约 2 分钟
# 安装/升级
在安装本插件时,确保你已成功安装ThinkPHP的项目并成功运行
安装方法参考:ThinkPHP5文档 (opens new window) ThinkPHP6文档 (opens new window)
注意、注意、注意!!!
本项目已迁移至 https://github.com/HGthecode/apidoc-php ,全新Apidoc兼容ThinkPHP、Laravel、Hyperf、Webman等基于Composer的PHP框架,更多实用功能。本项目不再维护,请移步新项目。
# 安装插件
进入ThinkPHP 项目根目录,执行如下命令:
composer require hg/apidoc-thinkphp
1
TP5版本需手动添加apidoc所需路由,如未自动生成config/apidoc.php 配置文件,可参考 没有生成apidoc.php配置文件解决方案
# 添加前端页面
请根据你安装的apidoc版本 点击下载 对应的前端文件
Apidoc版本 | Github | Gitee(国内推荐) |
---|---|---|
v3.1.0 - v3.1.9 | v2.1.6 (opens new window) | v2.1.6 (opens new window) |
v3.0.0 - v3.0.8 | v2.0.11 (opens new window) | v2.0.11 (opens new window) |
下载完成后解压,将apidoc文件夹拷贝到你的项目 public 目录下
打开浏览器访问 http://你的域名/apidoc/ ,出现接口文档页面,表示安装成功。
如遇页面报错或无法正常使用,可参考常见问题
# TP5添加路由
TP5版本需手动将apidoc所需路由添加到路由文件
// route/route.php
Route::group('apidoc', function () {
$controller_namespace = '\hg\apidoc\Controller@';
Route::get('config' , $controller_namespace . 'getConfig');
Route::get('apiData' , $controller_namespace . 'getApidoc');
Route::get('mdMenus' , $controller_namespace . 'getMdMenus');
Route::get('mdDetail' , $controller_namespace . 'getMdDetail');
Route::post('verifyAuth' , $controller_namespace . 'verifyAuth');
Route::post('generator' , $controller_namespace . 'createGenerator');
});
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11