ShowDoc就是一個非常適合IT團隊的在線文檔分享工具,使用的是一款非常輕量級的關系數據庫系統SQLite,支持多數SQL92標准。它可以加快團隊之間溝通的效率。
但是把所有的接口文檔寫在第三方的服務器上面,是不怎么安全的,所以想安裝到自己的開發服務器上面,僅供內網訪問。
它都有些什么功能?
1)分享與導出
2)權限管理 公開項目與私密項目|項目成員
3)編輯功能 包括markdown編輯|模板插入|歷史版本
安裝ShowDoc
①、如果你熟悉命令行,則可通過Composer安裝。
②、如果采用手動方式安裝,則請下載代碼:https://github.com/star7th/showdoc點擊打開鏈接
我選擇的是手動安裝,
1)首先從https://github.com/star7th/showdoc下載壓縮包
2) 然后用rz命令上傳到服務器上,也可以用上傳工具,比如WinSCP等
3)下載的是showdoc-master.zip,是一個用uzip命令解壓,你可以改成你想要的文件名
4)配置虛擬主機
我的服務器用的tenginx, 編輯配置文件 vi xx/tenginx/conf/vhosts.conf ,在末尾添加如下:
5)重啟tenginx服務
6)在瀏覽器地址欄 showdoc.wanshifu.com/install 開啟安裝
可能出現以下提示,說明文件寫入權限,按下面提示給文件權限。eg: chomod -R 777 Public/Uploads
然后出現安裝頁面,按提示安裝即可
7) 安裝成功后,注冊登陸后,建立一個test項目,很方便快捷,也美觀
注意事項:
文件夾權限
請確保/Application/Runtime 、 /Public/Uploads 、 /Sqlite 、 /Sqlite/showdoc.db.php 有可寫權限
如何關閉驗證碼
/Application/Common/Conf/Config.php 配置項里面增加 ‘CloseVerify’ => true,然后刪除/Application/Rumtime下的所有文件(這些都是緩存)