ShowDoc介紹
關於ShowDoc的介紹,請訪問:http://blog.star7th.com/2015/11/1816.html
環境依賴
1、必需環境
- PHP5.3以上版本、php-gd庫
2、可選環境
- php-mysql模塊、php-pdo模塊、mysql數據庫
-
ShowDoc默認使用Sqlite數據庫,數據庫文件在/Sqlite目錄下。PHP環境默認支持Sqlite,無需額外安裝其他數據庫。如果想使用Mysql數據庫,則需要安裝環境並參考下文的數據庫配置說明做相應配置。
###安裝和配置
1、全新安裝
- 克隆或者下載代碼:
https://github.com/star7th/showdoc -
文件夾權限
請確保/Application/Runtime 、 /Public/Uploads 、 /Sqlite 、 /Sqlite/showdoc.db.php 有可寫權限 -
Windows服務器
在php.ini里面把”extension=php_sqlite.dll”啟用以便開啟對Sqlite的支持;也啟用php_mbstring.dll;Linux服務器則不需要此操作。
2、升級安裝
- 下載新代碼后,除了/Sqlite目錄下的所有文件和/Public/Uploads里的文件外(若存在的話),全部覆蓋原來的代碼。重新賦予相應文件夾權限,根據自己需要更改配置(如使用mysql的需要更改配置信息)。覆蓋代碼后,先不要直接訪問首頁。而是先備份數據庫,然后在瀏覽器訪問http://xxxx.com/index.php?s=/home/update/db 升級數據庫結構,之后就可以正常訪問首頁了。
數據庫
1、Sqlite數據庫 or Mysql數據庫?
ShowDoc默認使用Sqlite數據庫,並且自動集成到/Sqlite目錄下。用戶下載代碼后即可使用,無需再安裝其他數據庫環境(PHP環境已經內置支持Sqlite數據庫)。
使用Sqlite數據庫是為了方便,尤其對非web開發人員來說是個福音。但如果你需要使用Mysql數據庫,ShowDoc也提供支持。但值得注意的是,ShowDoc只能在初始時選擇一種數據庫。如果你在使用過程中切換到了另一種數據庫,則有丟失原來數據的風險。
ShowDoc早期默認使用Mysql數據庫,這部分老用戶升級時請繼續且只能使用Mysql數據庫。請參考下文的配置方式
2、Mysql數據庫的配置方式
打開Application\Common\Conf\config.php,將第5、6行注視掉,然后開啟第8、9行(把注釋去掉)。效果應該如下:
//使用sqlite數據庫(ShowDoc默認) //'DB_TYPE' => 'Sqlite', //'DB_NAME' => 'Sqlite/showdoc.db.php', //使用mysql數據庫 'DB_TYPE' => 'mysql', 'DB_NAME' => 'showdoc',
此時填寫上相應的數據庫配置信息,如數據庫密碼等。如果你已經在瀏覽器中訪問過ShowDoc,記得把生成的緩存刪除掉以讓新配置生效。緩存文件在目錄/Application/Runtime下。
3、導入數據庫
將根目錄的showdoc.sql文件導入Mysql數據庫
錯誤排查
部署時出錯,請先確認是否按照文檔步驟執行(例如說目錄權限有沒有)。然后進Application/Runtime/Log 看一下日志,或清除下Application/Runtime/目錄下所有文件和子目錄(這些都是緩存)試試。再遇到無法解決的問題可上github和博客搜索下有沒有已解決的的問題。也可以加qq交流群564671853。再不行還可以聯系我,聯系方式有博客、github、郵件等。
其他可選配置
- 驗證碼
\Application\Common\Conf/Config.php 配置項里面增加 ‘CloseVerify’ => true 即可關閉驗證碼
使用在線的ShowDoc
如果你沒有自己的服務器,但又想使用ShowDoc作為分檔分享工具,你可以使用在線的ShowDoc http://doc.star7th.com
http://doc.star7th.com 作為在線服務會長期維護,請放心托管你的文檔數據,不用擔心突然關站的問題。如對數據非常敏感的個人或企業,還是把ShowDoc部署到自己的服務器比較好。
ShowDoc交流群
- ShowDoc使用交流qq群
群號:564671853
更多
更多請訪問:http://doc.star7th.com/3