部署 ShowDoc 到自己的伺服器

躍然發表於2017-10-31
伺服器

一、部署到自己的伺服器

  • 環境要求

    PHP5.3以上版本、php-mbstring模組、php-pdo模組、mysql資料庫

  • 克隆或者下載程式碼：

    https://github.com/star7th/showdoc

  • 匯入資料庫

    下載程式碼後，將根目錄的showdoc.sql檔案匯入mysql資料庫。（注意，需要建立本地 mysql 資料庫，並將 showdoc.sql 指令碼匯入到資料庫）

  • 修改配置檔案

    進入Application/Common/Conf/目錄，編輯config.php檔案，填寫相應的資料庫資訊

  • 目錄許可權

    請確保Application/Runtime 和Public/Uploads 有可寫許可權

  • 錯誤排查

    部署時出錯，請先確認是否按照上面步驟執行（例如說目錄許可權有沒有）。然後進Application/Runtime/Log看一下日誌，或清除下Application/Runtime/目錄下所有檔案（快取來的）試試。再遇到無法解決的問題可聯絡我，聯絡方式有部落格、github、郵件等。

  • nginx下的重定向規則

    請參考：http://blog.star7th.com/2016/03/1969.html

二、Mac 下配置Apache+PHP 環境

1. Apache 常用命令：
  • 開啟Apache：sudo apachectl start
  • 關閉Apache：sudo apachectl stop

  • 重啟Apache：sudo apachectl restart

    　　在瀏覽器中輸入localhost，如果出現如下預設的“It works!”介面，則表示Apache開啟成功。

2. 開啟PHP

在終端輸入命令：

sudo vim /etc/apache2/httpd.conf

找到下面一行程式碼，去掉註釋（刪除前面的井號）。注意：這裡是重點，不反註釋這個，showdoc 資料夾無訪問許可權。

#LoadModule php7_module libexec/apache2/libphp7.so

mac下Apache的預設資料夾為
/Library/WebServer/Documents，在該目錄下，將下載好的 showdoc 原始碼放入，命名資料夾為showdoc, 然後在瀏覽器中輸入localhost/showdoc，即可訪問本地搭建的 ShowDoc 服務了。

3. 修改Apache目錄

當然也可以根據自己喜好修改專案根目錄。修改方法為：

1. 開啟終端，輸入命令：sudo vim /etc/apache2/httpd.conf
2. 找到如下兩處
　　DocumentRoot "/Library/WebServer/Documents"
　　<Directory "/Library/WebServer/Documents">
3. 將兩處中引號中的目錄替換為自定義的目錄

完成以上三步後，重啟Apache，將之前建立的index.php檔案拷貝到自定義目錄中，然後在瀏覽器中輸入localhost，如果出現PHP的info頁，則表示目錄修改成功。

參考：
1. https://github.com/star7th/showdoc
2. showdoc 中文版教程
3. mac下配置Apache+PHP+MySQL環境

相關文章