array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.snmp3-walk.php', 1 => 'snmp3_walk', 2 => 'Получает все объекты SNMP из агента', ), 'up' => array ( 0 => 'ref.snmp.php', 1 => 'Функции SNMP', ), 'prev' => array ( 0 => 'function.snmp3-set.php', 1 => 'snmp3_set', ), 'next' => array ( 0 => 'function.snmpget.php', 1 => 'snmpget', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/snmp/functions/snmp3-walk.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

snmp3_walk

(PHP 4, PHP 5, PHP 7, PHP 8)

snmp3_walk — Получает все объекты SNMP из агента

Описание

snmp3_walk(
    string $hostname,
    string $security_name,
    string $security_level,
    string $auth_protocol,
    string $auth_passphrase,
    string $privacy_protocol,
    string $privacy_passphrase,
    array|string $object_id,
    int $timeout = -1,
    int $retries = -1
): array|false

Функция snmp3_walk() используется для чтения всех значений из агента SNMP, указанного в hostname.

Даже если уровень безопасности не использует протокол авторизации или пароль, необходимо указать корректные значения.

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

hostname
Имя хоста агента (сервера) SNMP.
security_name
Имя безопасности, обычно какое-то имя пользователя.
security_level
Уровень безопасности (noAuthNoPriv|authNoPriv|authPriv).
auth_protocol
Протокол аутентификации ("MD5", "SHA", "SHA256" или "SHA512").
auth_passphrase
Пароль для аутентификации.
privacy_protocol
Протокол конфиденциальности (DES или AES).
privacy_passphrase
Пароль конфиденциальности.
object_id
Если null, object_id берётся в качестве корня дерева объектов SNMP и все объекты этого дерева возвращаются в виде массива. Если указан object_id, возвращаются все объекты SNMP ниже этого object_id.
timeout
Время ожидания в микросекундах.
retries
Количество повторных попыток при истечении времени ожидания.

Возвращаемые значения

Возвращает массив значений объекта SNMP, начиная с object_id в качестве корня или false в случае возникновения ошибки.

Список изменений

Версия Описание
8.1.0 Параметр auth_protocol теперь принимает "SHA256" и "SHA512", если поддерживается libnetsnmp.

Примеры

Пример #1 Пример использования snmp3_walk()

<?php
$ret = snmp3_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName');
var_export($ret);
?>

Вызов функции вернёт все объекты SNMP из агента SNMP, запущенного на localhost: 

array (
  0 => 'STRING: lo',
  1 => 'STRING: eth0',
  2 => 'STRING: eth2',
  3 => 'STRING: sit0',
  4 => 'STRING: sixxs',
)

Смотрите также