array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.snmp3-real-walk.php', 1 => 'snmp3_real_walk', 2 => 'Return all objects including their respective object ID within the specified one', ), 'up' => array ( 0 => 'ref.snmp.php', 1 => 'SNMP 函数', ), 'prev' => array ( 0 => 'function.snmp3-getnext.php', 1 => 'snmp3_getnext', ), 'next' => array ( 0 => 'function.snmp3-set.php', 1 => 'snmp3_set', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/snmp/functions/snmp3-real-walk.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

snmp3_real_walk

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

snmp3_real_walk — Return all objects including their respective object ID within the specified one

说明

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

The snmp3_real_walk() function is used to traverse over a number of SNMP objects starting from object_id and return not only their values but also their object ids.

参数

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'));
?>

The above will output something like: 

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',
)

参见