SNMP 関数
PHP マニュアル

snmp_set_valueretrieval

SNMP の値が返される方法を設定する

説明

true snmp_set_valueretrieval(int $method)

パラメータ

method
型
SNMP_VALUE_LIBRARY Net-SNMP ライブラリの返す形式のままで返します。
SNMP_VALUE_PLAIN SNMP の型情報を含まないプレーンな値を返します。
SNMP_VALUE_OBJECT プロパティ value および type をもつオブジェクトを返します。 type は SNMP_OCTET_STR や SNMP_COUNTER などの定数のいずれかとなります。 value を返す方法は、定数 SNMP_VALUE_LIBRARY, SNMP_VALUE_PLAIN のどちらが設定されているかによって決まります。

戻り値

常に true を返します。

変更履歴

バージョン 説明
8.2.0 戻り値の型が、true になりました。これより前のバージョンでは、bool でした。

例

例1 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, see constants
 //   [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, see constants
 //   [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, see constants
 //   [value] => STRING: lo
 // )

?>

参考