搭建 ShowDoc 文档工具

准备 Nginx + PHP 环境

安装 Nginx

使用 yum 安装 Nginx：

yum -y install epel-release
yum -y install nginx

修改 /etc/nginx/nginx.conf 文件：

... ...
http {
    ... ...
    server {
        ... ...
        root         /var/www/html;  # 网站根目录
        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           /var/www/html;
            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 并设置为开机启动：

systemctl start nginx
systemctl enable nginx

安装 PHP

使用 yum 安装 php-fpm：

yum -y install php php-gd php-fpm php-mcrypt php-mbstring php-mysql php-pdo

启动 php-fpm 并设置为开机启动：

systemctl start php-fpm
systemctl enable php-fpm

创建项目

下载安装 Composer

Composer 是 PHP 的一个依赖管理工具，推荐使用 Composer 创建 ShowDoc 项目。

执行如下命令安装 Composer：

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

安装过程可能需要耗费几分钟

设置 Composer 使用国内镜像

执行命令设置 Composer 使用国内镜像：

composer config -g repo.packagist composer https://packagist.phpcomposer.com

为了避免访问国外网络导致的延迟，推荐使用国内镜像源

使用 Composer 创建项目

执行命令创建项目：

cd /var/www/html && composer create-project showdoc/showdoc

设置 showdoc 目录写权限

执行命令赋予 showdoc 下部分目录的写权限

chmod a+w showdoc/install
chmod a+w showdoc/Sqlite
chmod a+w showdoc/Sqlite/showdoc.db.php
chmod a+w showdoc/Public/Uploads/
chmod a+w showdoc/Application/Runtime
chmod a+w showdoc/server/Application/Runtime
chmod a+w showdoc/Application/Common/Conf/config.php
chmod a+w showdoc/Application/Home/Conf/config.php

创建完毕，您现在可以通过浏览器访问 http://<您的 CVM IP 地址>/showdoc/install/ ，进行语言的选择以后即可通过 http://<您的 CVM IP 地址>/showdoc 查看站点效果。

关闭SELinux

1、临时关闭

setenforce 0

2、永久关闭

vim /etc/selinux/config

​修改为以下内容

SELINUX=enforcing

---

转自：腾讯云实验室