SNMP::getnext
(PHP 5 >= 5.4.0)
SNMP::getnext — Récupère un objet SNMP qui suit l'identifiant d'objet fourni
Description
Récupère un objet SNMP qui suit l'objet spécifié par le
paramètre object_id
.
Liste de paramètres
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).
Valeurs de retour
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.
Erreurs / Exceptions
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.
Exemples
Exemple #1 Un seul objet SNMP
<?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);
?>
<?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 )
Voir aussi
- SNMP::getErrno() - Récupère le dernier code erreur
- SNMP::getError() - Récupère le dernier message d'erreur