如何部署ShowDoc/ShowDoc部署手册

ShowDoc介绍

关于ShowDoc的介绍，请访问：http://blog.star7th.com/2015/11/1816.html

Docker环境 或 PHP环境

• 如果你使用Docker安装ShowDoc，则无须再手动安装PHP环境。请忽略本文后续教程，跳转至：http://www.showdoc.cc/help?page_id=65610 ，
• 如果你手动安装PHP环境，可参考：http://www.showdoc.cc/php 。ShowDoc需要PHP5.3及以上版本、php-gd库、php-pdo模块。

安装ShowDoc

1、全新安装

• 如果你熟悉命令行，则可通过Composer安装：http://www.showdoc.cc/help?page_id=32238 。如果采用手动方式安装，则请下载代码：
  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/ （请将网址更改为你服务器域名或ip）。安装完毕后可使用默认账号showdoc（密码：123456）登录，也可以自行注册账户

2、升级安装

• 如果你是ShowDoc早期使用mysql数据库的那部分用户，请参考这里转移数据 http://www.showdoc.cc/help?page_id=31990 其他用户请忽略本段话，往下看。
• 如果你熟悉命令行，则可通过Composer升级：http://www.showdoc.cc/help?page_id=32238 。如果采用手动方式安装，则请下载代码：
  https://github.com/star7th/showdoc
• 备份旧代码目录
• 全新安装（具体操作参考上面”全新安装”部分的文字）并初始化ShowDoc完毕后，进入之前备份的目录。将Sqlite/sqlite.db.php（这是原来的数据库文件），以及Public/Uploads/下的所有文件（这些是上传的图片。如没有图片则可忽略之），全部复制并覆盖到新showdoc目录的相应文件。
• 覆盖文件后，用浏览器访问http://xxx.com/showdoc/index.php?s=/home/update/db （请将网址更改为你服务器域名或ip）。看到OK字样便证明成功升级.

错误排查

• 常见问题：http://www.showdoc.cc/3&page_id=16118
• 部署时出错，请先确认是否按照文档步骤执行（例如说目录权限有没有）。然后进Application/Runtime/Log 看一下日志，并试图在互联网上搜索下该错误提示看有没有人遇到类似的问题。或清除下Application/Runtime/目录下所有文件和子目录（这些都是缓存）试试。再遇到无法解决的问题可上github和博客搜索下有没有已解决的的问题。也可以加qq交流群564671853。再不行还可以联系我，联系方式有博客、github、邮件等。

其他可选配置

• 如何关闭验证码/Application/Common/Conf/Config.php 配置项里面增加 ‘CloseVerify’ => true，然后删除/Application/Rumtime下的所有文件（这些都是缓存）

使用在线的ShowDoc

• 如果你没有自己的服务器，但又想使用ShowDoc作为分档分享工具，你可以使用在线的ShowDoc http://www.showdoc.cc
• http://www.showdoc.cc 作为在线服务会长期维护，请放心托管你的文档数据。

ShowDoc交流群

• ShowDoc使用交流qq群
  交流群①：564671853（已满）
  交流群②：174709989

文章来源：https://www.showdoc.cc/help?page_id=13732