Showdoc

ShowDoc介紹
關於ShowDoc的介紹，請訪問：http://blog.star7th.com/2015/11/1816.html
環境依賴
1、必需環境

PHP5.3及以上版本、php-gd庫、php-pdo模塊

2、可選環境

• php-mysql模塊、php-pdo模塊、mysql5.5及以下版本
• ShowDoc默認使用Sqlite數據庫，數據庫文件在/Sqlite目錄下。PHP環境默認支持Sqlite，無需額外安裝其他數據庫。如果想使用Mysql數據庫，則請在安裝的時候選擇Mysql數據庫

安裝和配置
1、PHP環境的安裝

　請先安裝好PHP運行環境。可參考：http://www.showdoc.cc/php 。如已經安裝好，則請忽略此步驟。

2、全新安裝

• 克隆或者下載代碼：
https://github.com/star7th/showdoc
• 文件夾權限
請確保/Application/Runtime 、 /Public/Uploads 、 /Sqlite 、 /Sqlite/showdoc.db.php 有可寫權限
• Windows服務器
在php.ini里面把”extension=php_sqlite.dll”和”extension=php_pdo_sqlite.dll”啟用以便開啟對SQlite的支持；也啟用php_mbstring.dll；Linux服務器則不需要此操作。
• 運行安裝
http://xxxx.com/install/

3、升級安裝

• 備份舊代碼目錄/備份數據庫
• 下載新代碼。解壓到某目錄。復制舊代碼目錄的/Sqlite目錄下的所有文件、/Public/Uploads目錄下的所有文件、到新目錄的相應地方替換。
• 如果你是使用Sqlite數據庫，則直接復制 新/Application/Common/Conf/Config.php來覆蓋舊的
• 如果你是使用Mysql數據庫，則打開新的/Application/Common/Conf/Config.php，看看有沒有新增什么鍵值。如果有，則自己編輯舊config.php把這些鍵值加上去。保留舊的config文件，不要用新的覆蓋。大部分情況下，很少會有鍵值更新。
• 在瀏覽器訪問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數據庫。
錯誤排查
• 常見問題：http://www.showdoc.cc/3&page_id=16118
• 部署時出錯，請先確認是否按照文檔步驟執行（例如說目錄權限有沒有）。然后進Application/Runtime/Log 看一下日志，並試圖在互聯網上搜索下該錯誤提示看有沒有人遇到類似的問題。或清除下Application/Runtime/目錄下所有文件和子目錄（這些都是緩存）試試。再遇到無法解決的問題可上github和博客搜索下有沒有已解決的的問題。也可以加qq交流群564671853。再不行還可以聯系我，聯系方式有博客、github、郵件等。
其他可選配置
• 驗證碼
/Application/Common/Conf/Config.php 配置項里面增加 ‘CloseVerify’ => true 即可關閉驗證碼
使用在線的ShowDoc
• 如果你沒有自己的服務器，但又想使用ShowDoc作為分檔分享工具，你可以使用在線的ShowDochttp://www.showdoc.cc
http://www.showdoc.cc 作為在線服務會長期維護，請放心托管你的文檔數據，不用擔心突然關站的問題。如對數據非常敏感的個人或企業，還是把ShowDoc部署到自己的服務器比較好。

php環境安裝：
Centos
　以Centos6.6、通過yum安裝為例子。需要編譯安裝的請暫先搜索網絡教程，這里尚未來得及整理。
　首先你需要安裝web服務器，apache或者nginx中的一個（如果已安裝了請忽略），然后再安裝PHP環境配合使用

安裝 Apache + PHP
yum install httpd
yum install php php-gd php-mcrypt php-mbstring php-mysql php-pdo
service httpd start
chkconfig httpd on

　安裝完畢后，默認的Apache Web目錄是/var/www/html，將ShowDoc上傳並安裝部署手冊安裝即可

安裝Nginx + PHP
yum install nginx
yum install php php-gd php-fpm php-mcrypt php-mbstring php-mysql php-pdo
安裝完后，在/etc/nginx/conf.d新建文件127.0.0.1.conf
server {
        listen       8081;
        server_name  123.56.2.32;
        root         /home/web/showdoc;
        index index.php index.html;

        error_page  404              /404.html;
        location = /40x.html {
        }

        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
        }

        location ~ \.php$ {
            root           /home/web/showdoc;
            fastcgi_pass   unix:/dev/shm/php-cgi.sock;
            fastcgi_index  index.php;
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
            include        fastcgi_params;
        }

        location ~ /\.ht {
            deny  all;
        }
}
保存。然后執行命令：
service nginx start
service php-fpm start
chkconfig php-fpm on
chkconfig nginx on

然后進入目錄/var/www/html（不存在則新建），將ShowDoc上傳並按照部署手冊(http://blog.star7th.com/2016/05/2007.html )安裝即可。安裝后便可通過瀏覽器訪問123.56.2.32:8081

學習教程：
http://www.showdoc.cc/php?page_id=14595 php環境安裝
http://www.showdoc.cc/help?page_id=14 showdoc軟件教程
http://blog.star7th.com/2016/05/2007.html showdoc部署手冊!