Apache 安装 ShowDoc 文档服务器

在 CentOS 7 上使用 httpd（Apache） 启动 ShowDoc 的完整流程如下，涵盖安装、配置和启动步骤：

1. 安装依赖软件

1.1 安装 httpd（Apache）

yum install -y httpd
systemctl start httpd
systemctl enable httpd  # 设置开机自启

1.2 安装 PHP 及相关扩展

ShowDoc 需要 PHP 7.0+，推荐 PHP 7.3 或 7.4：

yum install -y epel-release
yum install -y php74 php74-php-fpm php74-php-mysqlnd php74-php-mbstring php74-php-curl php74-php-gd php74-php-pdo

说明：

• 如果系统默认是 PHP 5.x，需先移除旧版本：

  yum remove php*
  

• 启用 PHP 短标签支持（避免 phpinfo() 无法输出）：

  sed -i 's/short_open_tag = Off/short_open_tag = On/' /etc/opt/remi/php74/php.ini
  

1.3 安装 MariaDB/MySQL

yum install -y mariadb-server mariadb
systemctl start mariadb
systemctl enable mariadb
mysql_secure_installation  # 设置 root 密码并加固数据库

2. 配置数据库

2.1 创建 ShowDoc 数据库

mysql -u root -p

输入密码后，执行：

CREATE DATABASE showdoc CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON showdoc.* TO 'showdoc_user'@'localhost' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;
EXIT;

3. 下载并部署 ShowDoc

3.1 下载 ShowDoc

cd /var/www/html
wget https://github.com/star7th/showdoc/archive/refs/heads/master.zip
unzip master.zip
mv showdoc-master showdoc
chown -R apache:apache showdoc  # 赋予 Apache 用户权限
chmod -R 755 showdoc           # 设置目录权限

3.2 配置 Apache 虚拟主机

创建 /etc/httpd/conf.d/showdoc.conf：

<VirtualHost *:80>
    ServerName your_domain_or_ip
    DocumentRoot /var/www/html/showdoc

    <Directory /var/www/html/showdoc>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog /var/log/httpd/showdoc_error.log
    CustomLog /var/log/httpd/showdoc_access.log combined
</VirtualHost>

启用重写模块：

sed -i 's/AllowOverride None/AllowOverride All/g' /etc/httpd/conf/httpd.conf
systemctl restart httpd

4. 安装 ShowDoc

4.1 访问安装页面

在浏览器访问：

http://your_server_ip/install

填写数据库信息：

• 数据库主机：localhost
• 数据库名：showdoc
• 用户名：showdoc_user
• 密码：your_password

4.2 完成安装

• 按照网页提示完成安装。
• 删除 install 目录（安全考虑）：

  rm -rf /var/www/html/showdoc/install
  

5. 启动 ShowDoc

5.1 确保服务运行

systemctl status httpd  # 检查 Apache 是否运行
systemctl restart httpd # 重启 Apache 加载配置

5.2 访问 ShowDoc

在浏览器访问：

http://your_server_ip

默认管理员账号：

• 用户名：showdoc
• 密码：123456（安装后建议修改）

常见问题解决

1. 500 Internal Server Error

• 原因：目录权限不足或 SELinux 限制。
• 解决：

  chown -R apache:apache /var/www/html/showdoc
  chmod -R 755 /var/www/html/showdoc
  setenforce 0  # 临时关闭 SELinux
  sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config  # 永久关闭
  

2. 页面空白或 PHP 错误

• 原因：PHP 扩展未启用或配置错误。
• 解决：

  yum install -y php74-php-mbstring php74-php-gd  # 确保扩展已安装
  systemctl restart php74-php-fpm httpd
  

3. 数据库连接失败

• 原因：数据库服务未运行或配置错误。
• 解决：

  systemctl status mariadb  # 检查数据库状态
  mysql -u root -p -e "SHOW DATABASES;"  # 测试数据库连接
  

总结

1. 安装依赖：httpd + PHP 7.4 + MariaDB。
2. 配置数据库：创建 showdoc 数据库和用户。
3. 部署 ShowDoc：下载源码并赋予权限。
4. 配置 Apache：设置虚拟主机并启用重写。
5. 访问安装：通过浏览器完成安装并启动。

如果遇到问题，优先检查 Apache 错误日志（/var/log/httpd/showdoc_error.log）和 PHP 错误日志（/var/log/httpd/error_log）。