(PHP 5 >= 5.4.0, PHP 7)
SNMP::getnext — Récupère un objet SNMP qui suit l'identifiant d'objet fourni
Récupère un objet SNMP qui suit l'objet spécifié par le
paramètre object_id
.
Si object_id
est une chaîne de caractères, alors
SNMP::get() retournera un objet
SNMP sous la forme d'une chaîne de caractères.
Si object_id
est un tableau, tous les
objets SNMP demandés seront retournés sous la
forme d'un tableau associatif d'identifiants d'objets
SNMP ainsi que leurs valeurs.
object_id
Le ou les objets SNMP (OID).
Retourne les objets SNMP demandés sous la
forme d'une chaîne de caractères ou d'un tableau, suivant le type
du paramètre object_id
ou FALSE
si
une erreur survient.
Cette méthode ne lance aucune exception par défaut.
Pour activer l'émission d'exceptions SNMPException lorsque
des erreurs de la bibliothèque surviennent,
le paramètre de la classe SNMP exceptions_enabled
doit être défini à la valeur correspondante. Voir les
explications sur SNMP::$exceptions_enabled
pour plus de détails.
Exemple #1 Un seul objet SNMP
Un seul objet SNMP peut être demandé de 2 façons : comme une chaîne, retournant ainsi une valeur sous forme de chaîne, ou comme un tableau contenant qu'un seul élément, retournant ainsi un tableau associatif.
<?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'exemple ci-dessus va afficher quelque chose de similaire à :
OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 Array ( [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 )
Exemple #2 Plusieurs objets 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();
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Array ( [SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8 [SNMPv2-MIB::sysLocation.0] => STRING: Nowhere )