[函数]snmp3_real_walk()函数—用法及示例

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

snmp3_real_walk — 返回所有对象，包括其指定的对象ID

说明

snmp3_real_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_real_walk()函数用于遍历从object_id开始的多个SNMP对象，不仅返回它们的值，还返回它们的对象id。

参数
hostname
The hostname of the SNMP agent (server).

security_name
the security name, usually some kind of username

security_level
the security level (noAuthNoPriv|authNoPriv|authPriv)

auth_protocol
the authentication protocol (MD5 or SHA)

auth_passphrase
the authentication pass phrase

privacy_protocol
the authentication protocol ("MD5", "SHA", "SHA256", or "SHA512")

privacy_passphrase
the privacy pass phrase

object_id
The SNMP object id.

timeout
The number of microseconds until the first timeout.

retries
The number of times to retry if timeouts occur.

返回值
Returns an associative array of the SNMP object ids and their values on success or false on error. In case of an error, an E_WARNING message is shown.

更新日志

版本	说明
8.1.0	The auth_protocol now accepts "SHA256" and "SHA512" when supported by libnetsnmp.

示例
示例 #1 Using snmp3_real_walk()

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

上面的命令将输出如下内容:

array (
  'IF-MIB::ifName.1' => 'STRING: lo',
  'IF-MIB::ifName.2' => 'STRING: eth0',
  'IF-MIB::ifName.3' => 'STRING: eth2',
  'IF-MIB::ifName.4' => 'STRING: sit0',
  'IF-MIB::ifName.5' => 'STRING: sixxs',
)