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

ShowDoc交流群

  • ShowDoc使用交流qq群
    群号:564671853

更多

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

转载于:https://www.cnblogs.com/code_fbi/p/5534638.html

你可能感兴趣的:(ShowDoc部署手册)