snmp_set_valueretrieval

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

snmp_set_valueretrieval — Especifica o método como os valores SNMP serão retornados

Descrição

function snmp_set_valueretrieval(int $method): true

Parâmetros

method
Tipos
SNMP_VALUE_LIBRARY Os valores de retorno serão aqueles retornados pela biblioteca Net-SNMP.
SNMP_VALUE_PLAIN Os valores de retorno serão o valor simples sem as informações do tipo SNMP.
SNMP_VALUE_OBJECT Os valores de retorno serão objetos com as propriedades value e type, onde esta última é uma das constantes SNMP_OCTET_STR, SNMP_COUNTER etc. A forma como value é retornado depende de qual das constantes SNMP_VALUE_LIBRARY, SNMP_VALUE_PLAIN está definida.

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão Descrição
8.2.0 O tipo do retorno agora é true; anteriormente, era bool.

Exemplos

Exemplo #1 Usando 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, veja as constantes
 //   [value] => lo
 // )

 snmp_set_valueretrieval(SNMP_VALUE_OBJECT | SNMP_VALUE_PLAIN);
 $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
 // stdClass Object
 // (
 //   [type] => 4        <-- SNMP_OCTET_STR, veja as 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, veja as constantes
 //   [value] => STRING: lo
 // )

?>

Veja Também