SNMP::set

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

SNMP::set — Встановлює значення об'єкта SNMP

Опис

public SNMP::set(array|string $objectId, array|string $type, array|string $value): bool

Запитує віддалений агент SNMP, що встановлює значення одного або декількох об'єктів SNMP, зазначених у objectId

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

Якщо objectId - це рядок (string), обидва typeиvalue також мають бути рядками (string). Якщо objectId- массив (array),value повинен бути масивом рівного розміру, що містить відповідні значення, type може бути рядком (string) (це значення буде використовуватися для всіх пар objectId-value) або масив рівного розміру з кожним значенням OID. Коли використовуються комбінації будь-яких інших параметрів, може відображатись ряд повідомлень E_WARNING із докладним описом.

objectId

Ідентифікатор об'єкта SNMP

Коли кількість OID у масиві object_id більше, ніж max_oids, метод набору властивостей об'єкта повинен використовувати кілька запитів для виконання запрошених оновлень значень. У цьому випадку перевірки типу та значення виконуються для кожного фрагмента, тому другий або наступні запити можуть завершитися помилкою через неправильний тип або значення запитаного OID. Щоб повідомити про це, з'являється попередження, коли кількість OID у масиві object_id перевищує max_oids.

type

MIB визначає тип ідентифікатора кожного об'єкта. Він має бути вказаний у вигляді одного символу з наступного списку.

types

=	Тип, який приймає MIB
i	INTEGER
u	INTEGER
s	STRING
x	HEX STRING
d	DECIMAL STRING
n	NULLOBJ
o	OBJID
t	TIMETICKS
a	IPADDRESS
b	BITS

Якщо при компіляції бібліотеки SNMP було визначено опцію OPAQUE_SPECIAL_TYPES, то також можуть бути використані такі типи:

types

U	unsigned int64
I	signed int64
F	float
D	double

Більшість цих значень використовує очевидний тип ASN.1. 's', 'x', 'd' і 'b' — це різні способи вказівки значення OCTET STRING, а беззнаковий тип 'u' також вказують для обробки значень Gauge32.

Якщо MIB-файли були завантажені в MIB-дерево за допомогою "snmp_read_mib" або були вказані в конфігураційному файлі libsnmp, то для вказівки параметра type можна використовувати нотацію '=', оскільки тип всіх ідентифікаторів об'єктів буде автоматично зчитаний з MIB.

Зверніть увагу, що є два способи встановити змінну типу BITS, наприклад "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https( 6)}":

• За допомогою типу "b" та списку бітових чисел. Не рекомендується використовувати цей метод, тому що GET-запит для того ж OID поверне, наприклад, 0xF8.
• За допомогою типу "x" та шістнадцяткового числа, але без (!) звичайного префікса "0x".

Докладніше дивіться у розділі з прикладами.

value

Нове значення.

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

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

Помилки

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

Приклади

Приклад #1 Встановити одиночний ідентифікатор об'єкта SNMP

Loading...
▶

Приклад #2 Встановити кілька значень за допомогою одного дзвінка SNMP::set()

Loading...
▶

Приклад #3 ИспользованиеSNMP::set()** для встановлення ідентифікатора об'єкта BITS SNMP**

Loading...
▶

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

• SNMP::get() - Отримує об'єкт SNMP