服务停止函数解析与示例

function service_stop(){
    name="$1"
    if [ "$(is_service_exists $name)" ]; then
        if [ "$(is_service_running $name)" ]; then
            if [ $? -eq 0 ]; then
                echo_success "$name stopped"
            else
                echo_fail "stop $name failed"
                raise "Failed to stop $name, please stop it manually by 'systemctl stop $name'"
            fi
        else
            ech_success "$name already stopped"
        fi
    fi
}

这段代码是一个Shell脚本函数，名为`service_stop`，其功能是尝试停止一个名为`$1`的服务。下面是对这段代码的逐行解释：

1. `function service_stop(){`：定义了一个名为`service_stop`的函数。

2. `name="$1"`：将传入的第一个参数（`$1`）赋值给变量`name`。在这个函数中，`$1`应该是你想要停止的服务的名称。

3. `if [ "$(is_service_exists $name)" ]; then`：这行代码调用一个名为`is_service_exists`的函数，并传入`$name`作为参数。如果`is_service_exists`函数返回非空值（即服务存在），则执行后面的代码块。

4. `if [ "$(is_service_running $name)" ]; then`：这行代码调用一个名为`is_service_running`的函数，并传入`$name`作为参数。如果`is_service_running`函数返回非空值（即服务正在运行），则执行后面的代码块。

5. `if [ $? -eq 0 ]; then`：`$?`是上一个命令的退出状态码。如果上一个命令（这里是`is_service_running`）执行成功（状态码为0），则执行后面的代码块。

6. `echo_success "$name stopped"`：如果服务停止成功，打印一条成功消息。

7. `else`：如果服务停止失败（即上一个命令的退出状态码非0），则执行这个`else`块。

8. `echo_fail "stop $name failed"`：打印一条失败消息，表示停止服务失败。

9. `raise "Failed to stop $name, please stop it manually by 'systemctl stop $name'"`：抛出一个错误，提示用户手动停止服务。

10. `fi`：结束`if [ $? -eq 0 ]`的条件判断。

11. `else`：如果服务没有在运行（即`is_service_running`返回空值），则执行这个`else`块。

12. `echo_success "$name already stopped"`：打印一条成功消息，表示服务已经停止。

13. `fi`：结束`if [ "$(is_service_running $name)" ]`的条件判断。

14. `fi`：结束`if [ "$(is_service_exists $name)" ]`的条件判断。

15. `}`：结束`service_stop`函数的定义。

**举例说明**：

假设你有一个名为`apache2`的Web服务，并且你想要编写一个脚本来停止这个服务。你可以调用这个`service_stop`函数，如下：

service_stop apache2

这个调用将执行以下步骤：

1. 将`apache2`赋值给变量`name`。
2. 检查`apache2`服务是否存在。
3. 如果存在，检查服务是否正在运行。
4. 如果正在运行，尝试停止服务。
5. 如果停止成功，打印`apache2 stopped`。
6. 如果停止失败，打印`stop apache2 failed`并提示用户手动停止服务。
7. 如果服务已经停止，打印`apache2 already stopped`。

请注意，这段代码依赖于`is_service_exists`和`is_service_running`这两个函数，它们需要在脚本的其他部分定义，以便`service_stop`函数能够正确执行。