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