centos7下安裝apidoc

提早安裝好Web服務器

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

若是xz命令不存在則先安裝xz:

https://sourceforge.net/projects/lzmautils/files/latest/download?source=typ_redirect

上傳安裝包到服務器，解壓，安裝

tar -zxvf xz-5.2.4.tar.gz
cd xz-5.2.4
mkdir /usr/local/xz
./configure --prefix=/usr/local/xz     #指定安裝目錄
make && make install    #編譯並安裝

設置環境變量

vi /etc/profile
//在 export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL 一行的上面添加以下內容:
export XZ_HOME=/usr/local/xz
export PATH=${XZ_HOME}/bin:$PATH
source /etc/profile

再解壓:

​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/​​​n​o​d​e​j​s​/bin/node /usr/local/bin

測試版本號:

node -v

2：安裝apidoc

npm install apidoc -g

3.建立測試文件，apidoc.json文件和test.php文件

{
  "name": "****",
  "title": "****API",
  "description":"****API接口文檔",
  "url" : "http://api.demo.com",
  "version": "0.1.0"
}

/**
 * @api {post} /shop/getList 經過商家id獲取店鋪列表
 * @apiGroup Shop
 *
 * @apiParam (params) {int} id      商家id
 * @apiParamExample 請求參數Demo:
 *      {
 *        "id": 2,
 *       }
 *
 * @apiSuccess {Array} article 返回相應id的文章信息
 *
 * @apiSuccessExample Success-Response:
 *    HTTP/1.1 200 OK
 *      {
 *        "tile": "文章標題2",
 *        "date": 1483941498230,
 *        "author": "classlfz",
 *        "content": "文章的詳細內容"
 *       }
 *
 * @apiSampleRequest http://51.133.54.142
 */

4：生成對應的接口文檔 

apidoc -i input_your_file/ -o output_your_file/

其中input_your_file放置的是事先按照apidoc格式編寫好的js文件，output_your_file則指定了生成的html的位置(nginx網站目錄下) 

最終效果展現: