函数名:win32_stop_service()
适用版本:仅适用于 Windows 平台,PHP 5.1.0 及以上版本
函数说明:win32_stop_service() 函数用于停止指定的 Windows 服务。
语法:bool win32_stop_service(string $servicename [, string $machine ])
参数:
- $servicename:要停止的服务的名称,必须是一个有效的服务名称字符串。
- $machine(可选):指定服务所在的远程机器名称,如果未指定,默认为本地机器。
返回值:成功时返回 true,失败时返回 false。
示例:
// 停止本地机器上的 "MyService" 服务
if (win32_stop_service("MyService")) {
echo "服务停止成功!";
} else {
echo "服务停止失败!";
}
// 停止远程机器上的 "MyService" 服务
if (win32_stop_service("MyService", "remoteMachine")) {
echo "服务停止成功!";
} else {
echo "服务停止失败!";
}
注意事项:
- 在使用该函数之前,需要确保 PHP 安装了 Win32Service 扩展。
- 该函数需要在以管理员身份运行的 PHP 环境中调用,否则可能会因权限不足而导致失败。
- 如果服务已经停止或不存在,则调用该函数也会返回 true。
- 如果服务正在运行,但停止失败,则调用该函数会返回 false。