(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::getnext() 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.
Lance une SNMPException si une erreur de la bibliothèque survient
et que son type est inclus dans le masque de bits SNMP::$exceptions_enabled.
Sinon, émet un E_WARNING.
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 ne 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
)