适合IT团队的在线文档私人分享工具——showdoc部署【显哥出品，必为精品】

文章目录[隐藏]

一、部署Nginx+PHP环境
二、下载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新建文件showdoc.conf

server {
        listen       80;
        server_name  127.0.0.1;
        root         /code;  #项目地址
        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           /code;  #项目地址
            fastcgi_pass   127.0.0.1:9000;
            fastcgi_index  index.php;
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
            include        fastcgi_params;
        }
        location ~ /\.ht {
            deny  all;
        }
    }

保存，重启nginx和php

systemctl restart nginx php-fpm

二、下载showdoc及安装升级

克隆或者下载代码：

yum install -y git
git  clone  https://github.com/star7th/showdoc.git
mv  -f  showdoc/*  /code/

文件夹权限

请确保/Application/Runtime 、 /Public/Uploads 、 /Sqlite 、 /Sqlite/showdoc.db.php 有可写权限

chmod -R 777 /code  #比较省事方便

升级安装

参考文档说明：https://www.showdoc.cc/help?page_id=1385767280275683

三、数据库

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和博客搜索下有没有已解决的的问题。

其他可选配置

验证码

\Application\Common\Conf/Config.php 配置项里面增加 ‘CloseVerify’ => true 即可关闭验证码

四、浏览器访问安装

https://www.XXX.com/install/index.php