On this page
apachectl-Apache HTTP 服务器控制接口
apachectl
是 Apache 超文本传输协议(HTTP)服务器的前端。它旨在帮助 Management 员控制 Apache httpd守护程序的功能。
apachectl
脚本可以在两种模式下运行。首先,它可以充当httpd命令的简单前端,该命令只需设置任何必要的环境变量,然后通过任何命令行参数调用httpd即可。其次,apachectl
可以充当 SysV 初始化脚本,采用诸如start
,restart
和stop
之类的简单单字参数,并将其转换为对httpd的适当 signal。
如果您的 Apache 安装使用非标准路径,则需要编辑apachectl
脚本以将适当的路径设置为httpd二进制文件。您还可以指定任何必要的httpd命令行参数。有关详细信息,请参见脚本中的 Comments。
apachectl
脚本成功返回 0 退出值,如果发生错误则返回> 0.有关更多详细信息,请查看脚本中的 Comments。
Synopsis
在直通模式下操作时,apachectl
可以接受httpd二进制文件可用的所有参数。
apachectl [ httpd-argument ]
在 SysV 初始化模式下操作时,apachectl
将执行简单的单字命令,如下所示。
apachectl command
Options
此处仅定义 SysV 初始化样式选项。其他参数在httpd手册页上定义。
start
- 启动 Apache httpd守护程序。如果已在运行,则给出错误。这等效于
apachectl -k start
。
- 启动 Apache httpd守护程序。如果已在运行,则给出错误。这等效于
stop
- 停止 Apache httpd守护程序。这等效于
apachectl -k stop
。
- 停止 Apache httpd守护程序。这等效于
restart
- 重新启动 Apache httpd守护程序。如果守护程序未在运行,它将启动。在启动重新启动之前,此命令会像
configtest
一样自动检查配置文件,以确保守护程序不会消失。这等效于apachectl -k restart
。
- 重新启动 Apache httpd守护程序。如果守护程序未在运行,它将启动。在启动重新启动之前,此命令会像
fullstatus
- 显示来自mod_status的完整状态报告。为此,您需要在服务器上启用mod_status并在系统上使用基于文本的浏览器(例如
lynx
)。可以通过在脚本中编辑STATUSURL
变量来设置用于访问状态报告的 URL。
- 显示来自mod_status的完整状态报告。为此,您需要在服务器上启用mod_status并在系统上使用基于文本的浏览器(例如
status
- 显示简短的状态报告。与
fullstatus
选项类似,除了省略了当前正在处理的请求列表。
- 显示简短的状态报告。与
graceful
- 正常重启 Apache httpd守护程序。如果守护程序未在运行,它将启动。这与正常重启不同,因为当前打开的连接不会中止。副作用是旧的日志文件不会立即关闭。这意味着,如果将其用于日志轮换脚本中,则可能需要相当长的延迟才能确保在处理旧日志文件之前将其关闭。在启动重新启动之前,此命令会像
configtest
一样自动检查配置文件,以确保 Apache 不会死机。这等效于apachectl -k graceful
。
- 正常重启 Apache httpd守护程序。如果守护程序未在运行,它将启动。这与正常重启不同,因为当前打开的连接不会中止。副作用是旧的日志文件不会立即关闭。这意味着,如果将其用于日志轮换脚本中,则可能需要相当长的延迟才能确保在处理旧日志文件之前将其关闭。在启动重新启动之前,此命令会像
graceful-stop
- 正常停止 Apache httpd守护程序。这与正常停止的不同之处在于,当前打开的连接不会中断。副作用是旧的日志文件不会立即关闭。这等效于
apachectl -k graceful-stop
。
- 正常停止 Apache httpd守护程序。这与正常停止的不同之处在于,当前打开的连接不会中断。副作用是旧的日志文件不会立即关闭。这等效于
configtest
- 运行配置文件语法测试。它解析配置文件,并报告
Syntax Ok
或有关特定语法错误的详细信息。这等效于apachectl -t
。
- 运行配置文件语法测试。它解析配置文件,并报告
以下选项在早期版本中可用,但已被删除。
startssl
- 要以 SSL 支持开始httpd,您应编辑配置文件以包含相关指令,然后使用常规
apachectl start
。
- 要以 SSL 支持开始httpd,您应编辑配置文件以包含相关指令,然后使用常规