La classe SNMP

Table des matières

(PHP 5 >= 5.4.0, PHP 7)

Introduction

Représente une session SNMP.

Retour à la première page de Manuel PHP Table des matières Haut

Synopsis de la classe

SNMP {

/* Propriétés */

public int $max_oids ;

public int $valueretrieval ;

public bool $quick_print ;

public bool $enum_print ;

public int $oid_output_format ;

public bool $oid_increasing_check ;

public int $exceptions_enabled ;

public array $info ;

/* Méthodes */

public __construct ( int $version , string $hostname , string $community [, int $timeout = 1000000 [, int $retries = 5 ]] )

public close ( void ) : bool

public get ( mixed $object_id [, bool $preserve_keys = FALSE ] ) : mixed

public getErrno ( void ) : int

public getError ( void ) : string

public getnext ( mixed $object_id ) : mixed

public set ( mixed $object_id , mixed $type , mixed $value ) : bool

public setSecurity ( string $sec_level [, string $auth_protocol = [, string $auth_passphrase = [, string $priv_protocol = [, string $priv_passphrase = [, string $contextName = [, string $contextEngineID = ]]]]]] ) : bool

public walk ( string $object_id [, bool $suffix_as_key = FALSE [, int $max_repetitions [, int $non_repeaters ]]] ) : array

/* Constantes */

const integer ERRNO_NOERROR = 0 ;

const integer ERRNO_GENERIC = 2 ;

const integer ERRNO_TIMEOUT = 4 ;

const integer ERRNO_ERROR_IN_REPLY = 8 ;

const integer ERRNO_OID_NOT_INCREASING = 16 ;

const integer ERRNO_OID_PARSING_ERROR = 32 ;

const integer ERRNO_MULTIPLE_SET_QUERIES = 64 ;

const integer ERRNO_ANY = 126 ;

const integer VERSION_1 = 0 ;

const integer VERSION_2C = 1 ;

const integer VERSION_2c = 1 ;

const integer VERSION_3 = 3 ;

}

Retour à la première page de Manuel PHP Table des matières Haut

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` ou `SNMP_VALUE_PLAIN`.

quick_print

Valeur du paramètre quick_print dans la bibliothèque NET-SNMP

Dé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ètre quick_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

Retour à la première page de Manuel PHP Table des matières Haut

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

Retour à la première page de Manuel PHP Table des matières Haut

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

Rechercher une fonction PHP

Version en cache

24/12/2024 14:13:00 Cette version de la page est en cache (à la date du 24/12/2024 14:13:00) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-class.snmp.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut