array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'snmp.construct.php', 1 => 'SNMP::__construct', 2 => 'Crée une instance SNMP représentant la session vers l\'agent distant SNMP', ), 'up' => array ( 0 => 'class.snmp.php', 1 => 'SNMP', ), 'prev' => array ( 0 => 'snmp.close.php', 1 => 'SNMP::close', ), 'next' => array ( 0 => 'snmp.get.php', 1 => 'SNMP::get', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/snmp/snmp/construct.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SNMP::__construct

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SNMP::__construct — Crée une instance SNMP représentant la session vers l'agent distant SNMP

Description

public SNMP::__construct(
    int $version,
    string $hostname,
    string $community,
    int $timeout = -1,
    int $retries = -1
)

Crée une instance SNMP représentant une session avec un agent SNMP distant.

Liste de paramètres

version
Version du protocole SNMP : SNMP::VERSION_1, SNMP::VERSION_2C, SNMP::VERSION_3.
hostname

L'agent SNMP. Le paramètre hostname peut être suffixé avec le port de l'agent optionnel SNMP après deux-points. Les adresses IPV6 doivent être entourées de crochets ([]) lors de l'utilisation d'en plus les ports. Si FQDN est utilisé pour le paramètre hostname, il sera résolu par l'extension PHP SNMP, et non par le moteur Net-SNMP. L'utilisation des adresses IPV6 lors de l'utilisation de FQDN peut être forcée en entourant FQDN de crochets. Voici quelques exemples :
IPv4 avec un port par défaut127.0.0.1
IPv6 avec un port par défaut::1 or [::1]
IPv4 avec un port spécifique127.0.0.1:1161
IPv6 avec un port spécifique[::1]:1161
FQDN avec un port par défauthost.domain
FQDN avec un port spécifiquehost.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
Spécifie le niveau de sécurité pour la version donnée. L'objectif de la chaîne d'accès community est spécifique à la version de SNMP :
SNMP::VERSION_1 public pour une permission en lecture seule ou private pour lecture-écriture
SNMP::VERSION_2C public pour une permission en lecture seule ou private pour lecture-écriture
SNMP::VERSION_3 Nom de sécurité SNMPv3, peut être l'un des suivants : noAuthNoPriv, authNoPriv (un mot de passe d'authentification et un protocole d'authentification sont requis), ou authPriv (un mot de passe et un protocole d'authentification, ainsi qu'un mot de passe et un protocole de confidentialité sont requis)
SNMPv3 nécessite la configuration des paramètres de session liés à la sécurité avec la méthode SNMP::setSecurity().
timeout
Le nombre de microsecondes avant le premier délai d'expiration.
retries
Le nombre de tentatives lorsqu'un délai d'expiration survient.

Erreurs / Exceptions

SNMP::__construct() lance une exception lorsque les paramètres sont faux ou que la version du protocole SNMP est inconnue.

Exemples

Exemple #1 Récupération de l'emplacement physique de l'hôte

<?php

$session = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
$sysdescr = $session->get("sysDescr.0");
echo "$sysdescr\n";

?>

Résultat de l'exemple ci-dessus est similaire à :

STRING: Test server

Voir aussi