搭建 ShowDoc 文档工具

腾讯云
入门
0 个任务
剩余 2 个名额

你还可以 创建 或者 使用已有 云主机不限时上机

实验内容

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

首次可免费使用云主机 45 分钟 ,到期后云主机将被重置并退库,若想保留成果请及时留用。

实验资源

云服务器

软件环境

CentOS 7.2 64 位

目录

# 搭建 ShowDoc 文档工具 ## 准备 Nginx + PHP 环境 > <time>10min ~ 20min</time> ### 安装 Nginx 使用 `yum` 安装 Nginx: ``` yum install nginx ``` 修改 [/etc/nginx/nginx.conf][modify-nginx] 文件为如下内容: > <locate for="modify-nginx" path="/etc/nginx/nginx.conf" hint="修改 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 ``` > <checker type="output-contains" command="netstat -npl" hint="nginx 未正常启动"> > <keyword regex="80" /> > </checker> ### 安装 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 ``` > <checker type="output-contains" command="netstat -npl" hint="php-fpm 未正常启动"> > <keyword regex="9000" /> > </checker> ## 创建项目 > <time>10min ~ 20min</time> ### 下载安装 Composer Composer 是 PHP 的一个依赖管理工具,推荐使用 Composer 创建 ShowDoc 项目。 执行如下命令[安装 Composer][install-composer]: > <bubble for="install-composer"> > 安装过程可能需要耗费几分钟 > </bubble> ``` curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer ``` > <checker type="output-contains" command="composer --version" hint="Composer 未安装成功"> > <keyword regex="Composer version" /> > </checker> ### 设置 Composer 使用国内镜像 执行命令[设置 Composer 使用国内镜像][mainland-composer]: > <bubble for="mainland-composer"> > 为了避免访问国外网络导致的延迟,推荐使用国内镜像源 > </bubble> ``` composer config -g repo.packagist composer https://packagist.phpcomposer.com ``` ### 使用 Composer 创建项目 执行命令创建项目: ``` cd /var/www/html/ && composer create-project showdoc/showdoc ``` > <checker type="output-contains" command="ls /var/www/html/showdoc" hint="未检测到创建项目,若您使用了自定义的路径或者名称创建项目"> > <keyword regex="install" /> > </checker> ### 设置 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://${runtime.vars.cvmIpAddress}/showdoc/install/ ,进行语言的选择以后即可通过 http://${runtime.vars.cvmIpAddress}/showdoc 查看站点效果。 ## 准备域名和解析 > <time>15min ~ 30min</time> ### 域名注册 注:如果您不需要通过域名访问您的站点,请通过`已完成,下一步`跳过`域名注册`环节 如果您需要使用域名,可以[在腾讯云上选购][buy_link],过程可以参考下面的视频。 * [视频 - 在腾讯云上购买域名][buy_domain_video] > <link for="buy_link" href="https://dnspod.qcloud.com/?fromSource=lab"></link> > <video for="buy_domain_video" platform="qq" vid="p05077pwelw" name="域名选购"></video> ### 域名解析 注:如果您不需要通过域名访问您的站点,请通过`已完成,下一步`跳过`域名解析`环节 域名购买完成后, 需要将域名解析到实验云主机上,实验云主机的 IP 为: ``` ${runtime.vars.cvmIpAddress} ``` 在腾讯云购买的域名,可以[到控制台添加解析记录][https://console.qcloud.com/domain],过程可参考下面的视频: * [视频 - 如何在腾讯云上解析域名][video_resolve_domain] > <video for="video_resolve_domain" platform="qq" vid="t0507ps9kxo" name="域名解析"></video> 域名设置解析后需要过一段时间才会生效,通过 `ping` 命令检查域名是否生效 [:question][replace],如: > <bubble for="replace">注意替换下面命令中的 `www.yourmpdomain.com` 为您自己的注册的域名</bubble> ``` ping www.yourdomain.com ``` 如果 ping 命令返回的信息中含有你设置的解析的 IP 地址,说明解析成功。 ### 大功告成! 恭喜,您的 ShowDoc 站点已经部署完成,您可以通过浏览器访问查看效果。 通过IP地址查看:[http://${runtime.vars.cvmIpAddress}/showdoc][] 通过域名查看:[http://www.yourdomain.com/showdoc][],其中替换 `www.yourdomain.com` 为之前申请的域名。