Apache HTTP 服务器控制接口

命令语法格式

在SysV init模式下，命令apache2ctl采用简单的单字命令，定义如下：

在传递模式下，命令apache2ctl可以使用httpd二进制文件的所有可用参数：

以上两种模式。

命令描述

命令apache2ctl是Apache超文本传输协议（HTTP）服务器的前端。 它旨在帮助管理员控制Apache apache2守护程序的功能。

注意：默认的Debian配置要求在/etc/apache2/envvars中设置环境变量APACHE_RUN_USER，APACHE_RUN_GROUP，APACHE_PID_FILE

脚本apache2ctl在成功时返回0退出值，如果发生错误则返回> 0。 有关更多详细信息，请查看脚本中的注释。

命令支持的选项及含义

该command可以是以下任何一个或多个选项：

start
启动Apache守护程序。 如果它已在运行，则给出错误。

stop
停止Apache守护程序。

restart
通过向它发送一个SIGHUP来重新启动Apache守护程序。 如果守护程序未运行，则启动它。 此命令在启动重新启动之前通过apache2ctl configtest自动检查配置文件，以捕获最明显的错误。 但是，由于配置问题，守护程序仍有可能死亡。

fullstatus
从mod_status中，显示完整状态报告。为此，您需要在服务器上启用mod_status模块，并在系统上使用基于文本的浏览器，例如lynx。 可以通过在/etc/apache2/envvars中设置APACHE_STATUSURL变量来设置用于访问状态报告的URL。

status
显示简要状态报告。 与fullstatus选项类似，只是省略了当前正在提供的请求列表。

graceful
通过向它发送SIGUSR1来优雅地重新启动Apache守护程序。 如果守护程序未运行，则启动它。 这与正常重启不同，因为当前打开的连接不会中止。 副作用是旧的日志文件不会立即关闭。 这意味着，如果在日志轮换脚本中使用，则可能需要大量延迟才能确保在处理旧日志文件之前将其关闭。 此命令在启动重新启动之前通过apache2ctl configtest自动检查配置文件，以捕获最明显的错误。 但是，由于配置问题，守护程序仍有可能死亡。

graceful-stop
优雅地停止Apache httpd守护进程。 这与正常停止不同，因为当前打开的连接不会中止。 副作用是旧的日志文件不会立即关闭。

configtest
运行配置文件语法测试。 它解析配置文件，并报告“Syntax Ok”或有关特定语法错误的信息。 此测试不会捕获所有错误。

help
显示简短的帮助信息。

旧版本命令

以下选项在早期版本中可用，但已被删除。

startssl
要使用SSL支持启动httpd服务，你应该编辑配置文件以包含相关指令，然后使用正常的apache2ctl start命令。

相关环境变量

命令apache2ctl的行为可以受这些环境变量的影响：

有关详细信息，请参阅脚本中的注释。 可以在/etc/apache2/envvars中设置这些变量（APACHE_ENVVARS除外）。

相关手册

apache2(8), /usr/share/doc/apache2/README.Debian.gz

参考文献

• man 8 apache2ctl, Version 2.4.25-3

更新日志

• 11/15/2018 创建文章