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