Створення модуля (інструкція)

Це покрокова інструкція, яка показує, як створити простий модуль фронтенду Zabbix. Ви можете завантажити всі файли цього модуля у вигляді ZIP-архіву: MyAddress.zip.

Що ви створите

У цьому уроці ви спочатку створите модуль інтерфейсу, який додає новий розділ меню Моя адреса, а потім перетворите його на [більш просунутий] (#part-iii---module-action) модуль інтерфейсу, який робить HTTP-запит до https://api.seeip.org і відображає відповідь - IP-адресу вашого комп'ютера - на новій сторінці в новоствореному розділі меню Моя адреса. Ось як виглядатиме готовий модуль:

Частина I - Новий розділ меню

Додайте порожній модуль до інтерфейсу Zabbix

1. Створіть каталог MyAddress у каталозі modules вашої інсталяції web-інтерфейсу Zabbix (наприклад, zabbix/ui/modules).

2. Створіть файл manifest.json із базовими метаданими модуля (перегляньте опис підтримуваних параметрів).

ui/modules/MyAddress/manifest.json

{  "manifest_version": 2.0,  "id": "my-address",  "name": "My IP Address",  "version": "1.0",  "namespace": "MyAddress",  "description": "Моя зовнішня IP-адреса" }

3. У інтерфейсі Zabbix перейдіть до розділу Адміністрування → Загальні → Модулі та натисніть кнопку Сканувати каталог.

4. Знайдіть у списку новий модуль Моя IP-адреса та натисніть гіперпосилання «Дезактивовано», щоб змінити статус модуля з «Дезактивовано» на «Активовано».

Тепер модуль зареєстровано у фронтенді. Однак його ще не видно, тому що вам ще потрібно визначити функціональність модуля. Після того, як ви додасте контент до каталогу модулів, ви одразу побачите зміни у фронтенді Zabbix при оновленні сторінки.

Створення розділу меню

1. Створіть файл Module.php у каталозі MyAddress.

Цей файл реалізує новий клас Module, який розширює стандартний клас CModule. Клас Module вставить новий розділ меню My Address в головне меню.

Метод setAction() визначає дію, яка буде виконана після натискання на розділ меню. Для початку ви можете скористатися попередньо визначеною дією userprofile.edit, яка відкриє сторінку Профіль користувача. У частині III цієї інструкції ви дізнаєтесь, як створити користувацьку дію.

ui/modules/MyAddress/Module.php

<?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,  APP,  CMenuItem;  class Module extends CModule {   public function init(): void {  APP::Component()->get('menu.main')  ->add((новий CMenuItem(_('My Address')))  ->setAction('userprofile.edit'));  } }

3. Оновіть інтерфейс Zabbix. Тепер у нижній частині головного меню Zabbix є новий розділ Моя адреса. Натисніть Моя адреса, щоб відкрити сторінку Профіль користувача.

Частина II - Зміна розташування розділу меню

У цій частині ви перемістите розділ меню Моя адреса в розділ Моніторинг. У результаті користувачі матимуть доступ до двох сторінок підменю з розділу меню Моніторинг → Моя адреса.

1. Відкрийте та відредагуйте файл Module.php.

ui/modules/MyAddress/Module.php

<?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,  APP,  CMenuItem;  class Module extends CModule {   public function init(): void {  APP::Component()->get('menu.main')  ->findOrAdd(_('Monitoring'))  ->getSubmenu()  ->insertAfter(_('Discovery'),  (new CMenuItem(_('My Address')))->setAction('userprofile.edit')  );  } }

2. Оновіть інтерфейс Zabbix. Розгорніть розділ меню Моніторинг і зверніть увагу, що розділ Моя адреса тепер розташований під розділом Виявлення.

Частина III - Дія модуля

Дія реалізована в двох файлах - actions/MyAddress.php і views/my.address.php. Файл actions/MyAddress.php відповідає за реалізацію бізнес-логіки, тоді як файл views/my.address.php відповідає за зовнішній вигляд.

1. Створіть каталог actions у каталозі MyAddress.

2. Створіть файл MyAddress.php у каталозі actions.

Логіка дій буде визначена в класі MyAddress. Цей клас дій реалізує чотири функції: init(), checkInput(), checkPermissions() і doAction(). Фронтенд Zabbix запускає функцію doAction(), коли викликається дія. Ця функція відповідає за бізнес-логіку модуля.

ui/modules/MyAddress/actions/MyAddress.php

<?php  namespace Modules\MyAddress\Actions;  use CController,  CControllerResponseData;  class MyAddress extends CController {   public function init(): void {  $this->disableCsrfValidation();  }   protected function checkInput(): bool {  return true;  }   protected function checkPermissions(): bool {  return true;  }   protected function doAction(): void {  $data = ['my-ip' => file_get_contents("https://api.seeip.org")];  $response = new CControllerResponseData($data);  $this->setResponse($response);  } }

3. Створіть новий каталог views у каталозі MyAddress.

4. Створіть файл my.address.php у каталозі views і визначте вигляд модуля.

Зауважте, що змінна $data доступна у view без її спеціального визначення. Фреймворк автоматично передає асоціативний масив у view.

ui/modules/MyAddress/views/my.address.php

<?php  (new CHtmlPage())  ->setTitle(_('The HTML Title of My Address Page'))  ->addItem(new CDiv($data['my-ip']))  ->show();

5. Дія модуля має бути зареєстрована у файлі manifest.json. Відкрийте manifest.json і додайте новий об’єкт «actions», який містить:

• ключ дії з назвою дії, написаною малими літерами (a-z) і словами, розділеними крапками (наприклад, my.address);
• ім'я класу дії (MyAddress) як значення для ключа class об'єкта my.address;
• ім'я для view дії (my.address) як значення для ключа view об'єкта my.address.

ui/modules/MyAddress/manifest.json

{  "manifest_version": 2.0,  "id": "my-address",  "name": "My IP Address",  "version": "1.0",  "namespace": "MyAddress",  "description": "My External IP Address",  "actions": {  "my.address": {  "class": "MyAddress",  "view": "my.address"  }  } }

6. Відкрийте Module.php і змініть назву дії в методі setAction() на my.address.

ui/modules/MyAddress/Module.php

<?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,  APP,  CMenuItem;  class Module extends CModule {   public function init(): void {  APP::Component()->get('menu.main')  ->findOrAdd(_('Monitoring'))  ->getSubmenu()  ->insertAfter(_('Discovery'),  (new CMenuItem(_('My Address')))->setAction('my.address')  );  } }

7. Оновіть інтерфейс Zabbix. Натисніть на розділ меню Моя адреса, щоб побачити IP-адресу вашого комп’ютера.