动作负责模块的“业务逻辑”。一个动作通常由一个控制器和一个动作视图组成。
一个模块可以:
要使用某些自定义行为覆盖默认动作行为,请在模块配置中定义一个同名的动作。当调用该动作时,将执行模块的动作而不是默认的Zabbix动作。
动作文件应存储在actions文件夹中。这些动作需要在manifest.json中进行指定。
动作控制器工作流程:
检查用户权限。
根据传递的参数准备数据:如果 checkInput() 返回 true,Zabbix 将调用控制器的 doAction() 方法。
为视图准备 $data array:使用 CControllerResponseData 和 setResponse() 方法将响应存储在 $data array 中。
示例:
/**
* Validate input parameters.
*
* @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;
}
/**
* Check user permissions.
*
* @return bool
*/
protected function checkPermissions() {
return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN;
}
/**
* Execute action and generate response object.
*/
protected function do Action(): void {
$data = [
'hosts_count' => API::Host()->get([
'countOutput' => true,
'filter' => [
'status' => $this->getInput('status')
]
])
];
$this->setResponse(new CControllerResponseData($data));
}
您可以在 Zabbix 中查看可用控制器类的完整列表 source code。