SNMP::get

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SNMP::get — Отримує об'єкт SNMP

Опис

public SNMP::get(array|string $objectId, bool $preserveKeys = false): mixed

Отримує об'єкт SNMP, вказаний у objectId, за допомогою запиту GET.

Список параметрів

Якщо objectId є рядком, то SNMP::get() поверне об'єкт SNMP у вигляді рядка. Якщо objectId є масивом, всі запитані об'єкти SNMP будуть повернуті як асоціативний масив ідентифікаторів об'єктів SNMP та їх значень.

objectId

Об'єкт SNMP (OID) або об'єкти

preserveKeys

КогдаobjectId є масивом і для параметра preserveKeysустановлено значение**true** ключі в результатах будуть взяті так само, як у objectId, інакше властивість SNMP::oid_output_format використовується визначення форми ключів.

Значення, що повертаються

Повертає запитані об'єкти SNMP у вигляді рядка або масиву залежно від типу objectIdили**false**в случае возникновения ошибки.

Помилки

Цей метод за промовчанням не генерує виняток. Щоб увімкнути генерацію виключення SNMPException при виникненні деяких помилок цієї бібліотеки, необхідно встановити параметр exceptions_enabledкласса SNMP в соответствующее значение. Подробнее смотрите впоясненні параметра SNMP::$exceptions_enabled

Приклади

Приклад #1 Одиночний об'єкт SNMP

Одиночний об'єкт SNMP може бути запитаний двома способами: як рядкове значення, що повертається, або як одноелементний масив з асоціативним масивом як висновок.

Loading...
▶

Висновок наведеного прикладу буде схожим на:

Loading...
▶

Приклад #2 Множинні об'єкти SNMP

Loading...
▶

Висновок наведеного прикладу буде схожим на:

Array
(
    [SNMPv2-MIB::sysDescr.0] => STRING: Test server
    [SNMPv2-MIB::sysName.0] => STRING: myhost.nodomain
)

Дивіться також

• SNMP::getErrno() - Отримує код останньої помилки
• SNMP::getError() - Отримує останнє повідомлення про помилку