snmp_set_valueretrieval

(PHP 4 >= 4.3.3, PHP 5)

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

Description

bool snmp_set_valueretrieval ( int $method = SNMP_VALUE_LIBRARY )

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

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`.

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

snmp_get_valueretrieval() - Retourne la méthode avec laquelle les valeurs SNMP seront retournées
Constantes pré-définies