CLII. Fonctions SNMP

Introduction

Pré-requis

Afin de pouvoir utiliser les fonctions SNMP sous Unix, vous aurez besoin d'installer le package » NET-SNMP . Sous Windows ces fonctions ne sont disponibles que sous NT, et pas sous Win95/98.

Installation

Important : afin d'utiliser le package UCD SNMP , vous devez mettre la variable NO_ZEROLENGTH_COMMUNITY à 1 avant de compiler. Après avoir configuré UCD SNMP , éditez le fichier config.h et recherchez la valeur NO_ZEROLENGTH_COMMUNITY . Décommentez la ligne avec le #define. Cela doit ressembler à ceci :


#define NO_ZEROLENGTH_COMMUNITY 1

     
Ensuite, compilez PHP avec l'option --with-snmp[=DIR] .

Si vous rencontrez des erreurs étranges de "segmentation fault", lors de l'utilisation des commandes SNMP , c'est que vous n'avez pas suivi les recommandations précédentes. Si vous ne voulez pas recompiler UCD SNMP , vous pouvez aussi recompiler PHP avec l'option --enable-ucd-snmp-hack qui évitera cette erreur.

La distribution Windows contient des fichiers nécessaires à SNMP dans le dossier mibs . Ce dossier doit être déplacé dans DRIVE:\usr\mibs , où DRIVE doit être remplacé par la lettre de driver où PHP est installé, c'est-à-dire, par exemple c:\usr\mibs .

Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

Types de ressources

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

SNMP_OID_OUTPUT_FULL (entier )
Depuis 5.2.0
SNMP_OID_OUTPUT_NUMERIC (entier )
Depuis 5.2.0
SNMP_VALUE_LIBRARY (entier )
SNMP_VALUE_PLAIN (entier )
SNMP_VALUE_OBJECT (entier )
SNMP_BIT_STR (entier )
SNMP_OCTET_STR (entier )
SNMP_OPAQUE (entier )
SNMP_NULL (entier )
SNMP_OBJECT_ID (entier )
SNMP_IPADDRESS (entier )
SNMP_COUNTER (entier )
SNMP_UNSIGNED (entier )
SNMP_TIMETICKS (entier )
SNMP_UINTEGER (entier )
SNMP_INTEGER (entier )
SNMP_COUNTER64 (entier )

Table des matières

snmp_get_quick_print — Lit la valeur courante de l'option quick_print de la bibliothèque UCD
snmp_get_valueretrieval — Retourne la méthode avec laquelle les valeurs SNMP seront retournées
snmp_read_mib — Lit et analyse un fichier MIB dans l'arbre actif MIB
snmp_set_enum_print — Retourne toutes les valeurs qui sont des énumérations avec leur valeur d'énumération au lieu de l'entier
snmp_set_oid_numeric_print — Retourne tous les objets y compris leur identifiant d'objet dans celui spécifié
snmp_set_oid_output_format — Définit le format de sortie OID
snmp_set_quick_print — Ecrit la valeur courante de l'option quick_print de la bibliothèque UCD
snmp_set_valueretrieval — Spécifie la méthode avec laquelle les valeurs SNMP seront retournées
snmpget — Reçoit un objet SNMP
snmpgetnext — Retourne un objet SNMP
snmprealwalk — Retourne tous les objets, y compris leur ID d'objet
snmpset — Configure un objet SNMP
snmpwalk — Reçoit tous les objets SNMP d'un agent
snmpwalkoid — Demande d'informations d'arbre sur une entité du réseau