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 启动服务器。