La classe SNMP
(PHP 5 >= 5.4.0)
Introduction
Représente une session SNMP.
Synopsis de la classe
$version
, string $hostname
, string $community
[, int $timeout
= 1000000
[, int $retries
= 5
]] )$sec_level
[, string $auth_protocol
=
[, string $auth_passphrase
=
[, string $priv_protocol
=
[, string $priv_passphrase
=
[, string $contextName
=
[, string $contextEngineID
=
]]]]]] )$object_id
[, bool $suffix_as_key
= FALSE
[, int $max_repetitions
[, int $non_repeaters
]]] )Propriétés
- max_oids
-
Nombre maximal de OID par demande GET/SET/GETBULK
- valueretrieval
-
Contrôle la façon dont les valeurs SNMP seront retournées
SNMP_VALUE_LIBRARY
Les valeurs retournées le seront de la même façon que par la bibliothèque Net-SNMP. SNMP_VALUE_PLAIN
Les valeurs retournées le seront en valeur pleine, sans le type SNMP. SNMP_VALUE_OBJECT
Les valeurs retournées le seront sous forme d'objets avec les propriétés "value" et "type", où le type pourra être une constante SNMP_OCTET_STR, SNMP_COUNTER etc... La façon dont la "value" est retournée est basée suivant la constante définie : SNMP_VALUE_LIBRARY
ouSNMP_VALUE_PLAIN
. - quick_print
-
Valeur du paramètre
quick_print
dans la bibliothèque NET-SNMPDéfinit la valeur du paramètre
quick_print
dans la bibliothèque NET-SNMP. Lorsqu'il est défini (1), la bibliothèque SNMP retournera des valeurs rapidement imprimables. Cela signifie uniquement que les valeurs seront imprimées. Lorsque le paramètrequick_print
n'est pas défini (par défaut), la bibliothèque UCD SNMP imprimera des informations additionnelles incluant le type de la valeur (i.e. IpAddress ou OID). De plus, si quick_print n'est pas activé, la bibliothèque imprimera les valeurs hexadécimales pour toutes les chaînes contenant jusqu'à 3 caractères. - enum_print
-
Contrôle la façon dont les valeurs enum sont imprimées.
Permet d'indiquer à walk/get etc. s'ils doivent automatiquement chercher les valeurs enum dans le MIIB et les retourner en plus de leurs chaînes humainement lisibles.
- oid_output_format
-
Contrôle le format de sortie OID
Représentation OID .1.3.6.1.2.1.1.3.0 pour diverses valeurs de oid_output_format SNMP_OID_OUTPUT_FULL
La forme complète, comme "iso.org.dod...." SNMP_OID_OUTPUT_NUMERIC
La forme numérique, comme ".1.3.6.1.4.1.8072.3.2.10" SNMP_OID_OUTPUT_MODULE
La forme courte, comme "NET-SNMP-TC::linux" SNMP_OID_OUTPUT_SUFFIX
TBD SNMP_OID_OUTPUT_UCD
TBD SNMP_OID_OUTPUT_NONE
TBD - oid_increasing_check
-
Contrôle la vérification de la désactivation pour l'augmentation de l'OID lors du parcours de l'arbre OID
Quelques agents SNMP sont connus pour retourner des OIDs dans la mauvais ordre, mais peuvent malgré tout continuer le parcours. D'autres agents retournent des OIDs dans la mauvais ordre et peuvent conduire la méthode SNMP::walk() dans une boucle infinie tant que la limite de mémoire n'est pas atteinte. La bibliothèque PHP SNMP, par défaut, effectue la vérification de l'augmentation de l'OID et stoppe le parcours sur l'arbre OID lorsqu'elle détecte une possible boucle en émettant une alerte. Définissez la variable oid_increasing_check à
FALSE
pour désactiver cette vérification. - exceptions_enabled
-
Contrôle quelle exception SNMPException sera émise au lieu des alertes. Utiliser l'opérateur OR des constantes
SNMP::ERRNO_*
. Par défaut, toutes les exceptions SNMP sont désactivées. - info
-
Propriété en lecture seul contenant la configuration de l'agent distant : nom d'hôte, port, délai d'expiration par défaut, nombre de récupération par défaut
Constantes pré-définies
Types d'erreurs SNMP
-
SNMP::ERRNO_NOERROR
-
Aucune erreur spécifique SNMP n'est survenue.
-
SNMP::ERRNO_GENERIC
-
Une erreur SNMP générique est survenue.
-
SNMP::ERRNO_TIMEOUT
-
Demande à l'agent SNMP d'atteindre le délai d'expiration.
-
SNMP::ERRNO_ERROR_IN_REPLY
-
L'agent SNMP retourne une erreur dans la réponse.
-
SNMP::ERRNO_OID_NOT_INCREASING
-
L'agent SNMP n'incrémente plus l'OID lors de l'exécution de la commande WALK (BULK). Ceci indique qu'un problème survient avec l'agent SNMP.
-
SNMP::ERRNO_OID_PARSING_ERROR
-
La bibliothèque échoue lors de l'analyse de l'OID (et/ou le type pour la commande SET). Aucune requête n'est effectuée.
-
SNMP::ERRNO_MULTIPLE_SET_QUERIES
-
La bibliothèque utilisera plusieurs requêtes pour l'opération SET demandée. Cela signifie que l'opération sera effectuée de façon non transactionnelle et que les morceaux suivants pourront échouer si un mauvais type ou une mauvaise valeur est fourni.
-
SNMP::ERRNO_ANY
-
Tous les codes opérateur OR des constantes SNMP::ERRNO_*.
Versions du protocole SNMP
-
SNMP::VERSION_1
-
SNMP::VERSION_2C
,SNMP::VERSION_2c
-
SNMP::VERSION_3
Sommaire
- SNMP::close — Ferme une session SNMP
- SNMP::__construct — Crée une instance SNMP représentant la session vers l'agent distant SNMP
- SNMP::get — Récupère un objet SNMP
- SNMP::getErrno — Récupère le dernier code erreur
- SNMP::getError — Récupère le dernier message d'erreur
- SNMP::getnext — Récupère un objet SNMP qui suit l'identifiant d'objet fourni
- SNMP::set — Définitl a valeur d'un objet SNMP
- SNMP::setSecurity — Configure les paramètres de sécurité des sessions SNMPv3
- SNMP::walk — Récupère le sous-objet d'un objet SNMP