ShowDoc部署手册

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作为分档分享工具，你可以使用在线的ShowDochttp://doc.star7th.com
http://doc.star7th.com 作为在线服务会长期维护，请放心托管你的文档数据，不用担心突然关站的问题。如对数据非常敏感的个人或企业，还是把ShowDoc部署到自己的服务器比较好。

ShowDoc交流群

ShowDoc使用交流qq群
群号：564671853

更多请访问：http://doc.star7th.com/3