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部署手册!