SNMP::getnext

(PHP 5 >= 5.4.0, PHP 7)

SNMP::getnextRécupère un objet SNMP qui suit l'identifiant d'objet fourni

Description

public SNMP::getnext ( mixed $object_id ) : mixed

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

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
)

Voir aussi