SNMP::getnext

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

SNMP::getnext — Fetch an SNMP object which follows the given object id

說(shuō)明

public SNMP::getnext(array|string $objectId): mixed

Fetch an SNMP object that follows specified objectId.

參數(shù)

If objectId is a string, then SNMP::getnext() will return SNMP object as string. If objectId is a array, all requested SNMP objects will be returned as associative array of the SNMP object ids and their values.

objectId

The SNMP object (OID) or objects

返回值

Returns SNMP objects requested as string or array depending on objectId type or false on error.

錯(cuò)誤／異常

本方法默認(rèn)不拋出任何異常。如果要在某些庫(kù)出錯(cuò)時(shí)拋出 SNMPException 異常，用戶(hù)需要將 SNMP 類(lèi)參數(shù) exceptions_enabled 設(shè)定為相應(yīng)的值。更多細(xì)節(jié)見(jiàn) SNMP::$exceptions_enabled 的解釋。

范例

示例 #1 Single SNMP object

Single SNMP object may be requested in two ways: as string resulting string return value or as single-element array with associative array as output.

<?php
  $session = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
  $nsysdescr = $session->getnext("sysDescr.0");
  echo "$nsysdescr\n";
  $nsysdescr = $session->getnext(array("sysDescr.0"));
  print_r($nsysdescr);
?>

以上例程的輸出類(lèi)似于：

OID: NET-SNMP-MIB::netSnmpAgentOIDs.8
Array
(
    [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8
)

示例 #2 Miltiple SNMP objects

<?php
  $session = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
  $results = $session->getnext(array("sysDescr.0", "sysName.0"));
  print_r($results);
  $session->close();
?>

以上例程的輸出類(lèi)似于：

Array
(
    [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8
    [SNMPv2-MIB::sysLocation.0] => STRING: Nowhere
)

參見(jiàn)