vampcheah / webman-api-doc
Webman plugin vampcheah/webman-api-doc
1.0.1
2023-01-08 08:15 UTC
This package is auto-updated.
Last update: 2024-06-11 19:09:27 UTC
README
webman 开发框架可用的 简单的 api-doc 文档 【注解】
#说明: 此代码来自源码,开源 git 地址:
https://github.com/itxq/api-doc-php
https://github.com/xianrenqh/api-doc-php
#说明: 此代码已经过部分修改,可能对于原来的效果及某些结构布局有不一样的结果。
安装
composer require vampcheah/webman-api-doc
使用
配置设置:
- 基本配置 路径:\config\plugin\vampcheah\api-doc-webman\app.php
可以设置基本信息。
重要:
基本设置中: api_doc->下的 class 设置项,一定要设置成自己要加载的 api 接口文档的类文件,多个用数组。
- 路由配置 路径:\config\plugin\vampcheah\api-doc-webman\route.php
路由设置里目前有两个路由:
- api 文档的前端访问路由
- apidoc 开启密码访问时,请求判断密码的校验地址路由
前端访问地址:
默认的: http://127.0.0.1:8787/apidoc
你可以自行更改路由 apidoc 来定义访问地址
api 类文件的使用方法:
打开你要设置的注解的 api 类文件,
例如:\app\api\controller\UserController.php
- 在 class UserController 之前增加注解代码:
/** * @title 会员Api * @desc API接口 * Class APi * @package app\api\controller */
- 在公共方法上增加注解代码:
- 注意: 必须在 function 上面注解或无法显示出文档
/** * @title 会员登录 * @url /api * @header string XX-token header传递的token 空 必须 * @param string method 路由参数 user.login 必须 * @param string mobile 用户名或手机号 空 必须 * @param string password 登录密码 空 必须 * @param int platform 平台类型 1 否 * @method POST * @code 200 成功 * @code 0 失败 * @json {"code":0,"msg":"没有找到此账号","data":[]} * @return int code 状态码 (具体参见状态码说明) * @return string msg 提示信息 */
- 来个控制器里的完整代码,仅做参考
<?php namespace app\api\controller; use app\common\model\User as UserModel; /** * @title 会员Api * @desc API接口 * Class APi * @package app\api\controller */ class UserController extends ApiController { /** * @title 会员登录 * @url /api * * @param string method 路由参数 user.login 必须 * @param string mobile 用户名或手机号 空 必须 * @param string password 登录密码 空 必须 * @param int platform 平台类型 1 否 * @method POST * * @code 200 成功 * @code 0 失败 * @json {"code":0,"msg":"没有找到此账号","data":[]} * @return int code 状态码 (具体参见状态码说明) * @return string msg 提示信息 */ public function user_login() { //你的逻辑,啦啦啦 } }
打完,手工。你学废了吗?