(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SNMP::getnext — Recupera un objeto SNMP que sigue al identificador de objeto proporcionado
Recupera un objeto SNMP que sigue al objeto especificado por el
argumento objectId
.
Si objectId
es una string, entonces
SNMP::get() devolverá un objeto
SNMP en forma de string.
Si objectId
es un array, todos los
objetos SNMP solicitados serán devueltos en forma de
un array asociativo de identificadores de objetos
SNMP así como sus valores.
objectId
El o los objetos SNMP (OID).
Devuelve los objetos SNMP solicitados en forma de
una string o de un array, según el tipo del argumento
objectId
o false
si ocurre un error.
Este método no lanza ninguna excepción de manera predeterminada.
Para poder lanzar una excepción SNMPException cuando ocurre alguno de los errores de la biblioteca
el parámetro exceptions_enabled
de la clase SNMP
se debería establecer al valor correspondiente. Véase
la explicación de SNMP::$exceptions_enabled
para más detalles.
Ejemplo #1 Un solo objeto SNMP
Un solo objeto SNMP puede ser solicitado de 2 maneras: como una cadena, devolviendo así un valor en forma de cadena, o como un array que contiene solo un elemento, devolviendo así un array asociativo.
<?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);
?>
El resultado del ejemplo sería algo similar a:
OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 Array ( [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 )
Ejemplo #2 Varios objetos SNMP
<?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();
?>
El resultado del ejemplo sería algo similar a:
Array ( [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 [SNMPv2-MIB::sysLocation.0] => STRING: Nowhere )