Apache HTTP 服务器控制接口
命令语法格式
在SysV init模式下,命令apache2ctl采用简单的单字命令,定义如下:
apache2ctl command
在传递模式下,命令apache2ctl可以使用httpd二进制文件的所有可用参数:
apache2ctl [httpd-argument]
以上两种模式。
命令描述
命令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 创建文章