部署 ShowDoc 到自己的服务器

一、部署到自己的服务器

• 环境要求

  PHP5.3以上版本、php-mbstring模块、php-pdo模块、mysql数据库

• 克隆或者下载代码：

  https://github.com/star7th/showdoc

• 导入数据库

  下载代码后，将根目录的showdoc.sql文件导入mysql数据库。（注意，需要创建本地 mysql 数据库，并将 showdoc.sql 脚本导入到数据库）

• 修改配置文件

  进入Application/Common/Conf/目录，编辑config.php文件，填写相应的数据库信息

• 目录权限

  请确保Application/Runtime 和Public/Uploads 有可写权限

• 错误排查

  部署时出错，请先确认是否按照上面步骤执行（例如说目录权限有没有）。然后进Application/Runtime/Log看一下日志，或清除下Application/Runtime/目录下所有文件（缓存来的）试试。再遇到无法解决的问题可联系我，联系方式有博客、github、邮件等。

• nginx下的重定向规则

  请参考：http://blog.star7th.com/2016/03/1969.html

二、Mac 下配置Apache+PHP 环境

1. Apache 常用命令：

• 开启Apache：sudo apachectl start
• 关闭Apache：sudo apachectl stop

• 重启Apache：sudo apachectl restart

  　　在浏览器中输入localhost，如果出现如下默认的“It works!”界面，则表示Apache开启成功。

2. 开启PHP

在终端输入命令：

sudo vim /etc/apache2/httpd.conf

找到下面一行代码，去掉注释（删除前面的井号）。注意：这里是重点，不反注释这个，showdoc 文件夹无访问权限。

#LoadModule php7_module libexec/apache2/libphp7.so

mac下Apache的默认文件夹为
/Library/WebServer/Documents，在该目录下，将下载好的 showdoc 源码放入，命名文件夹为showdoc, 然后在浏览器中输入localhost/showdoc，即可访问本地搭建的 ShowDoc 服务了。

3. 修改Apache目录

当然也可以根据自己喜好修改项目根目录。修改方法为：

1. 打开终端，输入命令：sudo vim /etc/apache2/httpd.conf
2. 找到如下两处
　　DocumentRoot "/Library/WebServer/Documents"
　　"/Library/WebServer/Documents">
3. 将两处中引号中的目录替换为自定义的目录

完成以上三步后，重启Apache，将之前创建的index.php文件拷贝到自定义目录中，然后在浏览器中输入localhost，如果出现PHP的info页，则表示目录修改成功。

参考：
1. https://github.com/star7th/showdoc
2. showdoc 中文版教程
3. mac下配置Apache+PHP+MySQL环境