SNMP::getnext

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SNMP::getnext — Récupère un objet SNMP qui suit l'identifiant d'objet fourni

Description

public SNMP::getnext(array|string $objectId): mixed

Récupère un objet SNMP qui suit l'objet spécifié par le paramètre objectId.

Liste de paramètres

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.

objectId

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 objectId 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);
?>

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
)

Voir aussi