(PHP 5 >= 5.4.0)
SNMP::__construct — Crée une instance SNMP représentant la session vers l'agent distant SNMP
$version
, string $hostname
, string $community
[, int $timeout = 1000000
[, int $retries = 5
]] )
version
Version du protocole SNMP :
SNMP::VERSION_1,
SNMP::VERSION_2C,
SNMP::VERSION_3.
hostname
L'agent SNMP. Le paramètre hostname
peut être préfixé avec le port de l'agent optionnel SNMP
après une virgule. Les adresses IPV6 doivent être entourées de crochets ([])
si vous utilisez en plus les ports. Si FQDN est utilisé pour le paramètre
hostname, il sera résolu par la bibliothèque php-snmp,
et non par le moteur Net-SNMP. L'utilisation des adresses IPV6
lors de l'utilisation de FQDN peut être forcé en entourant FQDN de crochets.
Voici quelques exemples :
| IPv4 avec un port par défaut | 127.0.0.1 |
| IPv6 avec un port par défaut | ::1 or [::1] |
| IPv4 avec un port spécifique | 127.0.0.1:1161 |
| IPv6 avec un port spécifique | [::1]:1161 |
| FQDN avec un port par défaut | host.domain |
| FQDN avec un port spécifique | host.domain:1161 |
| FQDN avec un port par défaut, forçage de l'utilisation d'adresses IPV6 | [host.domain] |
| FQDN avec un port spécifique, forçage de l'utilisation d'adresses IPV6 | [host.domain]:1161 |
community
community est spécifique à la version
SNMP :
| SNMP_VERSION_1 | Communauté SNMP |
| SNMP_VERSION_2C | Communauté SNMP |
| SNMP_VERSION_3 | Nom sécurisé SNMPv3 |
timeout
Le nombre de millisecondes avant le premier délai d'expiration.
retries
Le nombre de tentative lorsqu'un délai d'expiration survient.
Retourne un objet SNMP représentant l'agent distant SNMP.
SNMP::__construct() lance une exception lorsque les paramètres sont faux ou que la version du protocole SNMP est inconnue.
Exemple #1 Récupération de sysLocation
<?php
$session = new SNMP(SNMP_VERSION_1, "127.0.0.1", "public");
$sysdescr = $session->get("sysDescr.0");
echo "$sysdescr\n";
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
STRING: Test server