动作

动作是一个负责'业务逻辑'的模块。一个动作一般由一个触发器和一个动作视图组成。

模块可以做以下事情：

• 调用已经在Zabbix前端定义的动作。
• 通过自定义动作覆盖默认动作。
• 定义全新的动作。

如果想通过某些自定义行为去覆盖默认动作，请在模块配置中定义具有相同名称的动作。 当调用该动作时，模板动作会被执行，而不是Zabbix默认动作。

动作文档应该存储在actions文件夹中。动作需要被指定在manifest.json。

控制器

操作控制器工作流程：

1. 检查 HTTP 请求中传递的所有参数是否有效：

   • 调用控制器的 checkInput() 方法；
   • 使用 CNewValidator.php 中定义的验证规则；
   • 调用 validateInput() 方法。

2. 检查用户权限。

3. 根据传递的参数准备数据：如果 checkInput() 返回 true，Zabbix 会调用控制器的 doAction() 方法。

4. 为视图准备 $data 数组。使用 CControllerResponseData 和 setResponse() 方法将响应存储到 $data 数组中。

示例：

/**
 * 验证输入参数。
 *
 * @return bool
 */
protected function checkInput(): bool {
    $ret = $this->validateInput([
        'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED])
    ]);

    if (!$ret) {
        $this->setResponse(new CControllerResponseFatal());
    }

    return $ret;
}

/**
 * 检查用户权限。
 *
 * @return bool
 */
protected function checkPermissions() {
    return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN;
}

/**
 * 执行操作并生成响应对象。
 */
protected function do Action(): void {
    $data = [ 
        'hosts_count' => API::Host()->get([
            'countOutput' => true,
            'filter' => [
                'status' => $this->getInput('status')
            ]
        ]) 
    ];

    $this->setResponse(new CControllerResponseData($data));
}