(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 excepciones por omisión.
Para activar el lanzamiento de excepciones SNMPException cuando
ocurren errores de la biblioteca,
el parámetro de la clase SNMP exceptions_enabled
debe ser definido al valor correspondiente. Ver las
explicaciones sobre 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);
?>
Resultado del ejemplo anterior es 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();
?>
Resultado del ejemplo anterior es similar a :
Array ( [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 [SNMPv2-MIB::sysLocation.0] => STRING: Nowhere )