snmp_set_valueretrieval

(PHP 4 >= 4.3.3, PHP 5, PHP 7)

snmp_set_valueretrieval Spécifie la méthode avec laquelle les valeurs SNMP seront retournées

Description

snmp_set_valueretrieval ( int $method = SNMP_VALUE_LIBRARY ) : bool

Liste de paramètres

mehod
types
SNMP_VALUE_LIBRARY Les valeurs retournées seront celles retournées par la bibliothèque Net-SNMP.
SNMP_VALUE_PLAIN Les valeurs retournées seront brutes, sans l'ajout du type SNMP.
SNMP_VALUE_OBJECT Les valeurs retournées seront des objets avec les propriétés "value" et "type", où la seconde est une des constantes SNMP_OCTET_STR, SNMP_COUNTER etc.. La façon dont la "value" est retournée est basée suivant l'utilisation de la constante SNMP_VALUE_LIBRARY ou de la constante SNMP_VALUE_PLAIN.

Exemples

Exemple #1 Exemple avec snmp_set_valueretrieval()

<?php
 snmp_set_valueretrieval
(SNMP_VALUE_LIBRARY);
 
$ret snmpget('localhost''public''IF-MIB::ifName.1');
 
// $ret = "STRING: lo"

 
snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
 
$ret snmpget('localhost''public''IF-MIB::ifName.1');
 
// $ret = "lo";

 
snmp_set_valueretrieval(SNMP_VALUE_OBJECT);
 
$ret snmpget('localhost''public''IF-MIB::ifName.1');
 
// stdClass Object
 // (
 //   [type] => 4        <-- SNMP_OCTET_STR, voir les constantes
 //   [value] => lo
 // )

 // Exemples avec PHP 5.4+
 
snmp_set_valueretrieval(SNMP_VALUE_OBJECT SNMP_VALUE_PLAIN);
 
$ret snmpget('localhost''public''IF-MIB::ifName.1');
 
// stdClass Object
 // (
 //   [type] => 4        <-- SNMP_OCTET_STR, voir les constantes
 //   [value] => lo
 // )

 
snmp_set_valueretrieval(SNMP_VALUE_OBJECT SNMP_VALUE_LIBRARY);
 
$ret snmpget('localhost''public''IF-MIB::ifName.1');
 
// stdClass Object
 // (
 //   [type] => 4        <-- SNMP_OCTET_STR, voir les constantes
 //   [value] => STRING: lo
 // )

?>

Historique

Version Description
5.4.0

La constante SNMP_VALUE_PLAIN ou la constante SNMP_VALUE_LIBRARY peut être combinée à la constante SNMP_VALUE_OBJECT permettant ainsi une représentation différente du contenu des éléments du tableau value dans la valeur retournée de la fonction. Si aucune des constantes SNMP_VALUE_{PLAIN,LIBRARY} n'accompagne SNMP_VALUE_OBJECT, SNMP_VALUE_LIBRARY sera utilisé.

Avant la version 5.4.0, SNMP_VALUE_OBJECT signifiait effectivement SNMP_VALUE_OBJECT|SNMP_VALUE_PLAIN.

Voir aussi