作者：青山儿云作伴 | 来源：互联网 | 2023-05-17 05:14
1.先去官网下载已编译好的安装包以Centos7.464位为例,下载地址:https:nodejs.orgdistv8.1.2node-v8.1.2-linux-x64.tar.x
1.先去官网下载已编译好的安装包
以Centos7.4 64位为例, 下载地址: https://nodejs.org/dist/v8.1.2/node-v8.1.2-linux-x64.tar.xz
wget https://nodejs.org/dist/v8.1.2/node-v8.1.2-linux-x64.tar.xz
执行解xz命令:
xz -d node-v8.1.2-linux-x64.tar.xz
再解压:
tar -xvf node-v8.1.2-linux-x64.tar
解压好的目录移动到指定位置:
mv node-v8.1.2-linux-x64 /usr/local/nodejs
做命令连接:
ln -s /usr/local/nodejs/bin/node /usr/local/bin
ln -s /usr/local/nodejs/bin/npm /usr/local/bin
测试版本号:
完成
2：安装apidoc
/usr/local/nodejs/bin/npm install apidoc -g
安装成功一般提示：
安装失败可能是由于权限不足，重新加上sudo进行安装：
sudo /usr/local/nodejs/bin/npm install apidoc -g
提示“/usr/bin/env: node: No such file or directory” ，需执行以下命令解决
ln -s /usr/local/nodejs/bin/node /usr/bin/node
3.创建测试文件，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){}
4：生成对应的接口文档
采用下面的命令：
/usr/local/nodejs/bin/apidoc -i input_your_file/ -o output_your_file/
其中input_your_file放置的是事先按照apidoc格式编写好的js文件，output_your_file则指定了生成的html的位置。
例子如下：
注意：出现如下错误提示error: No files found，可能是某些文件导致出现的问题，需要自行确认查找那些文件影响了文档的生成
京公网安备 11010802041100号