apachectl - Apache HTTP服务器控制接口
apachectl
是Apache HTTP服务器的前端程序。其设计意图是帮助管理员控制Apache httpd
后台守护进程的功能。
apachectl
脚本有两种操作模式。首先,作为简单的httpd
的前端程序,设置所有必要的环境变量,然后启动httpd
,并传递所有的命令行参数。其次,作为SysV初始化脚本,接受简单的一个单词的参数,如:start
, restart
, stop
,并把他们翻译为适当的信号发送给httpd
。
如果你的Apache安装在非标准的路径中,你将需要修改apachectl
脚本使其中的路径正确地指向httpd
程序。此外,还可以指定任何必要的httpd
命令行参数。细节可以参见脚本中的注解。
apachectl
脚本如果执行成功,则返回0 ;如果出错,则其返回值>0 。更多细节可以参见脚本中的注解。
语法
在扮演传递角色时,apachectl
可以接受对httpd
程序有效的所有参数。
apachectl [ httpd-argument ]
在SysV初始化模式中,apachectl
只接受简单的一个单词的命令,如下:
apachectl command
选项
下列仅说明了SysV初始化类型的选项,其他参数的说明见httpd
手册页。
start
- 启动Apache
httpd
后台守护进程。如果已经启动,则产生一个错误。它等价于apachectl -k start
。 stop
- 停止Apache
httpd
后台守护进程。它等价于apachectl -k stop
。 restart
- 重新启动Apache
httpd
后台守护进程。如果守护进程尚未运行,则启动它。在重新启动守护进程之前,此命令会使用configtest
自动检查配置文件,以确保Apache不会死掉。它等价于apachectl -k restart
。 fullstatus
- 显示由
mod_status
提供的完整的状态报告。要使用这个功能,需要启用服务器上的mod_status
模块,并且系统中有一个基于文本的浏览器,如lynx
。修改脚本中的STATUSURL
变量,可以修改访问状态报告的URL 。 status
- 显示一个简要的状态报告。它类似于
fullstatus
选项,但是省略了正在处理的请求的列表。 graceful
- 优雅地重新启动Apache
httpd
后台守护进程。如果守护进程尚未启动,则启动它。它和标准重新启动的不同之处在于:不会中断当前已经打开的连接,也不会立即关闭日志。这意味着,如果在日志滚动脚本使用它,则在处理日志之前必须加入一个实实在在的延迟,以确保老的日志文件在被处理前已经关闭。在重新启动守护进程之前,此命令会使用configtest
自动检查配置文件,以确保Apache不会死掉。它等价于apachectl -k graceful
。 graceful-stop
- 优雅地停止Apache
httpd
后台守护进程。它和标准停止的不同之处在于:不会中断当前已经打开的连接,也不会立即关闭日志。它等价于apachectl -k graceful-stop
。 configtest
- 执行一次配置文件语法检查。它解析配置文件,并报告
Syntax Ok
或者是特定的语法错误详细信息。它等价于apachectl -t
。
下列选项仅在早期版本中使用,现在已经被废弃了。
startssl
- 以支持SSL的方式启动
httpd
,你应当编辑配置文件,并在其中包含与SSL支持相关的指令,然后使用apachectl start
启动服务器。