首页 > 代码库 > apidoc
apidoc
1、安装node
http://nodejs.cn/download/
下载二进制包,解压,配置环境
export NODE_HOME=/usr/local/node
export PATH=$NODE_HOME/bin:$PATH
node -v 检查
2、修改node默认镜像
npm config ls -l 查看配置项
npm config set registry "http://registry.npm.taobao.org"
3、全局安装apidoc
npm install apidoc -g
4、新建文件夹demo
5、创建apidoc.json文件和test.PHP文件
apidoc.json:
{ "name": "****", "title": "****API", "description":"****API接口文档", "url" : "http://api.demo.com", "version": "0.1.0" }
test.php文件
<?php /** * * @api {get} /user/{id} * @apiDescription 获取用户信息接口描述 * @apiGroup User * @apiName getUserInfo * @apiParam {Number} id 用户ID * @apiVersion 0.1.0 * * * @apiExample {curl} 访问示例: * curl -i http://api.demo.com/user/4711 * * @apiSuccess {String} firstname Firstname of the User. * @apiSuccess {String} lastname Lastname of the User. */ function GetUser($id){}
6、进入demo目录,运行命令
apidoc
如果自定义文件后缀名:md,可用命令:apidoc -f ".*\.md$"
7、在该目录下会生成doc目录,直接访问即可
脚本:
echo "build api_rest API DOC ..."
cd /opt/git/api_rest
git fetch
git checkout $1
git pull
apidoc -i /opt/git/api_rest/ -o /opt/appdocs/api/
rm -rf /opt/tomcat/webapps/api
mv /opt/appdocs/api /opt/tomcat/webapps
echo "gen api_rest doc end ..."
apidoc
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。