(PHP 5 >= 5.4.0, PHP 7, PHP 8)
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 objectId.
Si objectId 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 objectId 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.
objectIdLe 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 objectId 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);
?>Résultat de l'exemple ci-dessus est 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();
?>Résultat de l'exemple ci-dessus est similaire à :
Array
(
[SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAgentOIDs.8
[SNMPv2-MIB::sysLocation.0] => STRING: Nowhere
)