Download the PHP package curselby/tp5-doc without Composer
On this page you can find all versions of the php package curselby/tp5-doc. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download curselby/tp5-doc
More information about curselby/tp5-doc
Files in curselby/tp5-doc
Download curselby/tp5-doc
More information about curselby/tp5-doc
Files in curselby/tp5-doc
Vendor curselby
Package tp5-doc
Short Description A doc package require thinkphp5
License Apache-2.0
Package tp5-doc
Short Description A doc package require thinkphp5
License Apache-2.0
Please rate this library. Is it a good library?
Informations about the package tp5-doc
Tp5-Doc
基于 thinkphp5 的doc文档扩展
[TOC]
说明
thinkphp5编写的自动生成文档功能;
- 文档生成
简洁,优雅,不需要额外的文档工具;
安装
-
如果想在你的TP5项目中使用,那么可以直接使用
-
如果是新项目先要创建tp5项目,然后再require
- 使用生成文档 需要在public/static/ 下 安装hadmin
使用
-
创建Doc文档显示控制器 wiki 继承 Tp5Doc\doc\Doc;
- 配置路由
3.配置文档显示目录
可以改写次方法以存储以无限级的方式,为了方便采用的是配置方式
tp5 增加额外配置 创建application/extra/api_doc.php 文件
参数 | 必须 | 备注 | 作用 |
---|---|---|---|
name | true | 接口列表名称 | 显示列表名称 |
id | true | 主键 | 生成列表所用 |
parent | true | 生成列表所用 | |
class | true | 接口位置 | 用于生成具体接口文档 |
readme | true | markdown | 可以生成没有接口的文档,比如一些说明 module和controller为空,readme填文档路径 |
3.具体接口文档配置
- 接口描述部分(类文件的注释)
参数 | 必须 | 备注 | 作用 |
---|---|---|---|
title | true | 接口标题 | 显示列表名称 |
url | true | 请求地址 | 用户显示 |
desc | true | 接口描述 | 显示描述 |
version | false | 版本号 | 版本号 |
readme | false | markdown文档 | 可以编写信息文档 |
-
具体接口文档
- 接口描述信息(注释填写)
参数 | 必须 | 备注 | 作用 |
---|---|---|---|
title | true | 接口标题 | 显示列表名称 |
desc | true | 接口描述 | 显示描述 |
readme | false | markdown文档 | 可以编写信息文档 |
2.请求参数
- 返回参数(注释填写)
参数 | 必须 | 备注 |
---|---|---|
第一个参数 | true | 类型 |
第二个参数 | true | 参数名 |
第三个参数 | true | 参数说明 |
类型填写规则
整体效果
All versions of tp5-doc with dependencies
PHP Build Version
Package Version
Requires
topthink/framework Version
^5.0
The package curselby/tp5-doc contains the following files
Loading the files please wait ....