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
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 of Contents
- 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