一、部署到自己的服務器
-
環(huán)境要求
PHP5.3以上版本传睹、php-mbstring模塊、php-pdo模塊沟绪、mysql數(shù)據(jù)庫
-
克隆或者下載代碼：
-
導入數(shù)據(jù)庫
下載代碼后，將根目錄的showdoc.sql文件導入mysql數(shù)據(jù)庫褪秀。（注意蓄诽，需要創(chuàng)建本地 mysql 數(shù)據(jù)庫，并將 showdoc.sql 腳本導入到數(shù)據(jù)庫）
-
修改配置文件
進入Application/Common/Conf/目錄媒吗，編輯config.php文件仑氛，填寫相應的數(shù)據(jù)庫信息
-
目錄權(quán)限
請確保Application/Runtime 和Public/Uploads 有可寫權(quán)限
-
錯誤排查
部署時出錯，請先確認是否按照上面步驟執(zhí)行（例如說目錄權(quán)限有沒有）闸英。然后進Application/Runtime/Log看一下日志锯岖，或清除下Application/Runtime/目錄下所有文件（緩存來的）試試。再遇到無法解決的問題可聯(lián)系我甫何，聯(lián)系方式有博客嚎莉、github、郵件等沛豌。
-
nginx下的重定向規(guī)則
二趋箩、Mac 下配置Apache+PHP 環(huán)境
1. Apache 常用命令：
- 開啟Apache：sudo apachectl start
- 關(guān)閉Apache：sudo apachectl stop
- 重啟Apache：sudo apachectl restart
在瀏覽器中輸入localhost，如果出現(xiàn)如下默認的“It works!”界面加派，則表示Apache開啟成功叫确。
2. 開啟PHP
在終端輸入命令：
sudo vim /etc/apache2/httpd.conf
找到下面一行代碼，去掉注釋（刪除前面的井號）芍锦。注意：這里是重點竹勉，不反注釋這個，showdoc 文件夾無訪問權(quán)限娄琉。
#LoadModule php7_module libexec/apache2/libphp7.so
mac下Apache的默認文件夾為
/Library/WebServer/Documents次乓，在該目錄下，將下載好的 showdoc 源碼放入孽水，命名文件夾為showdoc, 然后在瀏覽器中輸入localhost/showdoc票腰，即可訪問本地搭建的 ShowDoc 服務了。
3. 修改Apache目錄
當然也可以根據(jù)自己喜好修改項目根目錄女气。修改方法為：
1. 打開終端杏慰，輸入命令：sudo vim /etc/apache2/httpd.conf
2. 找到如下兩處
DocumentRoot "/Library/WebServer/Documents"
<Directory "/Library/WebServer/Documents">
3. 將兩處中引號中的目錄替換為自定義的目錄
完成以上三步后，重啟Apache炼鞠，將之前創(chuàng)建的index.php文件拷貝到自定義目錄中缘滥，然后在瀏覽器中輸入localhost，如果出現(xiàn)PHP的info頁谒主，則表示目錄修改成功朝扼。
4. 權(quán)限問題
因為團隊目前缺少一個文檔管理的工具，所以最近一直在研究ShowDoc霎肯，無論是部署安裝擎颖，還是編輯使用榛斯，ShowDoc非常容易上手，界面十分清爽簡潔肠仪。
但是有一個方面希望可以加強肖抱，即文檔與用戶的管理方面
如果在團隊中使用ShowDoc，會有如下幾種應用策略：
策略一：開發(fā)團隊共享一個ShowDoc公共賬號异旧，文檔的編輯均由開發(fā)團隊成員共同完成
優(yōu)點：一個賬號意述，無需管理賬號；文檔在一個公共賬號共享與編輯吮蛹，對文檔能統(tǒng)一管理
缺點：一個賬號擁有全部權(quán)限荤崇，文檔可能隨時被修改，雖然有版本潮针，但沒有版本比對术荤，不知道改了什么，也不知道是哪個開發(fā)人員改了每篷，更嚴重的是一旦有人將文檔刪除了瓣戚，只能通過恢復備份庫才能找回，文檔安全性方面不好管理焦读。
策略二：開發(fā)團隊每位成員都擁有自己的ShowDoc賬號子库，文檔的編輯由各個開發(fā)團隊在自己的賬號中完成，然后通過分享鏈接或者二維碼或者將其他人的賬號加入項目成員當中來共享開發(fā)文檔矗晃。
優(yōu)點：文檔歸項目創(chuàng)建者所有仑嗅，其他人沒有權(quán)限刪除文檔，文檔的安全性方面有了保障张症。
缺點：通過鏈接仓技、二維碼共享，需要其他人記住地址俗他，不方便傳播脖捻，將其他人員加入到項目成員，不利于某些全團隊共享的文檔的共享拯辙，且整個團隊的文檔無法統(tǒng)一進行管理郭变。
策略三：在策略二的基礎(chǔ)上，增加一個團隊公共賬號涯保，每個人新建的文檔項目需要將團隊公共賬號加入到項目成員中（只給只讀權(quán)限）
優(yōu)點：文檔歸項目創(chuàng)建者所有，其他人沒有權(quán)限刪除文檔周伦，文檔的安全性方面有了保障夕春，只要每位成員按照約定，將公共賬號添加到項目成員中专挪，團隊可以有統(tǒng)一的文檔中心及志。
缺點：需要創(chuàng)建者遵照約定片排，創(chuàng)建者可隨時將公共賬號的訪問權(quán)限刪除。
策略四：建一個管理員賬號速侈，所有文檔先由管理員賬號創(chuàng)建率寡，具體由誰負責編寫，只需將編輯權(quán)限賦予給誰即可倚搬，再建一個公共的只讀權(quán)限賬號冶共，整個團隊成員通過只讀權(quán)限賬號查看完整的文檔。
優(yōu)點：團隊的文檔可以統(tǒng)一管理每界，除了管理員賬號其他人沒有權(quán)限刪除文檔捅僵，文檔的安全性方面有保障。
缺點：分配權(quán)限需要專人處理眨层，且沒新增一個賬號都要添加一次庙楚，沒有權(quán)限組的概念，比較麻煩趴樱。
在一些小團隊中馒闷，可能策略一比較適合，但是在一些規(guī)模較大的團隊中叁征，會比較希望使用策略四纳账，但目前這一塊，類似于SVN那種分配權(quán)限組的方式航揉，ShowDoc暫時不支持塞祈。
三、ShowDoc 版本升級
開始我部署的老版本帅涂，使用的是mysql數(shù)據(jù)庫保存的信息议薪，現(xiàn)在 ShowDoc 官方建議使用 sqlite，我按照官方文檔更新了一下媳友，感覺官方文檔寫得不是很清晰斯议，這里總結(jié)一下。
全新安裝（具體操作參考上面“全新安裝”部分的文字）并初始化ShowDoc完畢后醇锚，進入之前備份的目錄哼御。將Sqlite/showdoc.db.php（這是原來的數(shù)據(jù)庫文件），以及Public/Uploads/下的所有文件（這些是上傳的圖片焊唬。如沒有圖片則可忽略之）恋昼，全部復制并覆蓋到新showdoc目錄的相應文件。覆蓋后重新給這些文件可寫權(quán)限赶促。
覆蓋文件后液肌，用瀏覽器訪問http://xxx.com/showdoc/index.php?s=/home/update/db （請將網(wǎng)址更改為你服務器域名或ip）∨副酰看到OK字樣便證明成功升級.
以上為官方給的方法嗦哆，這里有點讓人讀不太懂谤祖。實踐后原來是這樣的：
1. 在備份原來部署的 showdoc 項目。
2. 下載部署最新 showdoc 項目老速。
3. 將以前部署的 showdoc 項目文件夾下的 qlite/showdoc.db.php 以及 Public/Uploads/ 下的所有文件（這些是上傳的圖片粥喜。如沒有圖片則可忽略之），全部復制并覆蓋到新 showdoc 目錄的相應文件橘券。覆蓋后重新給這些文件可寫權(quán)限额湘。
4. 將 mysql 數(shù)據(jù)庫中已有數(shù)據(jù)寫入到新的 qlite 文件（showdoc.db.php），實現(xiàn)方法：修改新項目中 /showdoc/ThinkPHP/Library/Think/Db/Driver.class.php 文件约郁，將 “數(shù)據(jù)庫連接參數(shù)配置” 替換成自己以前的 mysql 數(shù)據(jù)庫配置缩挑。此步至關(guān)重要，官方文檔竟然沒有說明鬓梅！
5. 執(zhí)行 [http://xxx.com/showdoc/index.php?s=/home/update/db](http://xxx.com/showdoc/index.php?s=/home/update/db) （請將網(wǎng)址更改為你服務器域名或ip）供置。看到 ok 字樣便證明成功升級绽快。perfect!
參考：
