在 CentOS 上安装与管理 Apache 模块
一、准备与常用命令
- 安装 Apache（若尚未安装）：sudo yum install -y httpd
- 启动并设置开机自启：sudo systemctl start httpd && sudo systemctl enable httpd
- 常用模块查询与语法检查：
- 查看已加载模块：apachectl -M 或 httpd -M
- 检查配置语法：httpd -t
- 模块文件目录：/etc/httpd/modules/（用于确认 .so 模块文件是否存在）
二、安装模块的两类方式
-
方式一 通过软件包安装（推荐）
- 多数常用模块在官方仓库以软件包形式提供，安装包名通常形如：mod_模块名。
- 示例：
- 安装 SSL 模块：sudo yum install -y mod_ssl
- 安装 URL 重写模块：sudo yum install -y mod_rewrite
- 安装 PHP 模块（与 Apache 集成）：sudo yum install -y php
- 安装完成后，模块通常已被系统自动启用，可直接重启 Apache 生效：sudo systemctl restart httpd。
-
方式二 手动编译动态模块（当仓库无对应包时）
- 安装编译工具与依赖：sudo yum groupinstall -y “Development Tools”；sudo yum install -y httpd-devel apr-devel apr-util-devel
- 下载并解压 Apache 源码（与当前运行的 httpd -v 版本一致）：wget https://downloads.apache.org/httpd/httpd-2.4.xx.tar.bz2 && tar xf httpd-2.4.xx.tar.bz2 && cd httpd-2.4.xx
- 编译模块（以 mod_example 为例）：./configure --enable-example；make
- 复制模块到模块目录：sudo cp modules/example/.libs/mod_example.so /etc/httpd/modules/
- 在配置中加载模块：在 /etc/httpd/conf.modules.d/00-base.conf 或 /etc/httpd/conf/httpd.conf 中添加：LoadModule example_module modules/mod_example.so
- 语法检查与重启：httpd -t && sudo systemctl restart httpd
三、启用、禁用与验证
- 启用模块
- 软件包安装的模块一般无需额外操作；若未自动加载，可在 /etc/httpd/conf.modules.d/ 下新建或编辑 .conf 文件，添加 LoadModule 指令并重启。
- 禁用模块
- 在配置中注释或删除对应的 LoadModule 行，保存后重启 Apache。
- 验证
- 查看已启用模块：apachectl -M
- 确认模块文件存在：ls /etc/httpd/modules/mod_*.so
- 语法与运行状态：httpd -t && systemctl status httpd
四、常见示例
- 启用 mod_rewrite
- 安装：sudo yum install -y mod_rewrite
- 确保加载：grep -n “rewrite_module” /etc/httpd/conf.modules.d/*.conf /etc/httpd/conf/httpd.conf
- 在需要的虚拟主机或目录配置中设置：AllowOverride All（用于 .htaccess 生效）
- 验证与重启：apachectl -M | grep rewrite && sudo systemctl restart httpd
- 启用 mod_ssl
- 安装：sudo yum install -y mod_ssl
- 重启：sudo systemctl restart httpd
- 如启用防火墙，放行端口：sudo firewall-cmd --permanent --add-service=https && sudo firewall-cmd --reload
- 安装 PHP 模块并测试
- 安装：sudo yum install -y php
- 重启：sudo systemctl restart httpd
- 创建测试页：echo “” | sudo tee /var/www/html/info.php
- 浏览器访问：http://服务器IP/info.php
五、注意事项
- 不要混用 a2enmod/a2dismod（这是 Debian/Ubuntu 的模块管理工具），在 CentOS 上应通过软件包安装或编辑 LoadModule 指令来管理模块。
- 修改配置后务必先执行 httpd -t 检查语法，再重启服务，避免配置错误导致服务不可用。
- 若启用了防火墙（firewalld），记得放行 80/443 端口，或按需仅放行 443（启用 HTTPS 时）。
