基于 CentOS + Nginx + PHP 搭建 ShowDoc 文档工具

屏幕快照 2017-11-07 18.59.59.png

程序员都很希望别人能写文档,而自己却不愿意写文档。文档的编写和管理影响了团队沟通协作的效率,ShowDoc 是一个非常适合 IT 团队的在线文档分享工具,为提升团队之间的沟通协作效率而生。本实验带您在 centos 系统上搭建基于 Nginx + PHP 的 ShowDoc 文档工具。

文档API:https://www.showdoc.cc/help

示例:https://www.showdoc.cc/demo

任务大纲

1、准备 Nginx + PHP 环境(耗时:10min ~ 20min)

2、创建项目(耗时:10min ~ 20min)

3、准备域名和解析(耗时:15min ~ 30min)

一、准备 Nginx + PHP 环境

准备 Nginx + PHP 环境

1、安装 Nginx

使用 yum 安装 Nginx:

yum install nginx

修改 /etc/nginx/nginx.conf 文件为如下内容:

user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;

include /usr/share/nginx/modules/*.conf;

events {
    worker_connections 1024;
}

http {
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';
                      
    access_log  /var/log/nginx/access.log  main;
    
    sendfile            on;
    tcp_nopush          on;
    tcp_nodelay         on;
    keepalive_timeout   65;
    types_hash_max_size 2048;
    
    include             /etc/nginx/mime.types;
    default_type        application/octet-stream;
    include /etc/nginx/conf.d/*.conf;
    
    server {
        listen       80;
        server_name  127.0.0.1;
        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 并设置为开机启动:

service nginx start
chkconfig nginx on

日志

[root@VM_117_117_centos ~]# service nginx start
Redirecting to /bin/systemctl start  nginx.service
[root@VM_117_117_centos ~]# chkconfig nginx on
Note: Forwarding request to 'systemctl enable nginx.service'.
Created symlink from /etc/systemd/system/multi-user.target.wants/nginx.service to /usr/lib/systemd/system/nginx.service.

2、安装 PHP

使用 yum 安装 php-fpm:

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

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

service php-fpm start
chkconfig php-fpm on

日志

[root@VM_117_117_centos ~]# service php-fpm start
Redirecting to /bin/systemctl start  php-fpm.service
[root@VM_117_117_centos ~]# chkconfig php-fpm on
Note: Forwarding request to 'systemctl enable php-fpm.service'.
Created symlink from /etc/systemd/system/multi-user.target.wants/php-fpm.service to /usr/lib/systemd/system/php-fpm.service.
[root@VM_117_117_centos ~]#

二、创建项目

1、下载安装 Composer

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

执行如下命令安装 Composer:

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

2、设置 Composer 使用国内镜像

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

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

使用 Composer 创建项目

3、执行命令创建项目:

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

4、设置 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://119.29.239.104/showdoc/install/ ,进行语言的选择以后即可通过 http://119.29.239.104/showdoc 查看站点效果。

WX20171107-185344@2x.png

WX20171107-185653@2x.png

日志

[root@VM_117_117_centos ~]# curl -sS https://getcomposer.org/installer | php
All settings correct for using Composer
Downloading...
Composer (version 1.5.2) successfully installed to: /root/composer.phar
Use it: php composer.phar
[root@VM_117_117_centos ~]# mv composer.phar /usr/local/bin/composer
[root@VM_117_117_centos ~]# composer config -g repo.packagist composer https://packagist.phpcomposer.com
[root@VM_117_117_centos ~]# cd /var/www/html/ && composer create-project  showdoc/showdoc
Installing showdoc/showdoc (v1.8.4)
  - Installing showdoc/showdoc (v1.8.4): Downloading (100%)
Created project in /var/www/html/showdoc
Loading composer repositories with package information
Updating dependencies (including require-dev)
Nothing to install or update
Writing lock file
Generating autoload files

三、准备域名和解析

1、域名注册

注:如果您不需要通过域名访问您的站点,请通过已完成,下一步跳过域名注册环节

如果您需要使用域名,可以在腾讯云上选购,过程可以参考下面的视频。

视频 - 在腾讯云上购买域名

已完成,下一步

2、域名解析

注:如果您不需要通过域名访问您的站点,请通过已完成,下一步跳过域名解析环节

域名购买完成后, 需要将域名解析到实验云主机上,实验云主机的 IP 为:119.29.239.104

在腾讯云购买的域名,可以到控制台添加解析记录,过程可参考下面的视频:

视频 - 如何在腾讯云上解析域名

域名设置解析后需要过一段时间才会生效,通过 ping 命令检查域名是否生效 ,如:

ping www.yourdomain.com

如果 ping 命令返回的信息中含有你设置的解析的 IP 地址,说明解析成功。

3、大功告成!

恭喜,您的 ShowDoc 站点已经部署完成,您可以通过浏览器访问查看效果。

通过IP地址查看:http://119.29.239.104/showdoc

通过域名查看:http://www.yourdomain.com/showdoc,其中替换 www.yourdomain.com 为之前申请的域名。


本文根据腾讯实验室操作总结

未经允许请勿转载:程序喵 » 基于 CentOS + Nginx + PHP 搭建 ShowDoc 文档工具

点  赞 (0) 打  赏
分享到: