snmp_set_valueretrieval

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

    snmp_set_valueretrieval — 指定 SNMP 值的返回方式

    描述

    snmp_set_valueretrieval(int $method): true

    参数

    method
    类型
    SNMP_VALUE_LIBRARY 返回值将与 Net-SNMP 库返回的值相同。
    SNMP_VALUE_PLAIN 返回值将是纯值，不包含 SNMP 类型信息。
    SNMP_VALUE_OBJECT 返回值将是带有 value 和 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
    // )

    ?>

    参见

    改进此页面

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加笔记

    用户贡献笔记 3 notes

    0
    Mikhail D
    17 年前
    示例显示的是接口状态。
    (.iso.org.dod.internet.mgmt.mib-2.
    interfaces.ifTable.ifEntry.ifAdminStatus)
    此请求从 MIB 获取的可能值
    Enum(整数): up (1), down (2), testing (3)

    <?php
    //snmp_set_quick_print(0); // 默认
    $strIP = "10.1.1.1"; $strComm = "public";
    $strOID = ".1.3.6.1.2.1.2.2.1.7.1";
    echo     "\n 默认 valueretrieval with snmp_set_quick_print(0)";
    echo     " snmp_get_valueretrieval = SNMP_VALUE_LIBRARY";
    echo     ", retrieved value " . snmpget($strIP, $strComm, $strOID);
    snmp_set_valueretrieval(SNMP_VALUE_LIBRARY);
    echo     "\n SNMP_VALUE_LIBRARY " . snmp_get_valueretrieval();
    echo     ", retrieved value " . snmpget($strIP, $strComm, $strOID);
    snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
    echo     "\n SNMP_VALUE_PLAIN " . snmp_get_valueretrieval();
    echo     ", retrieved value " . snmpget($strIP, $strComm, $strOID);

    snmp_set_quick_print(1);
    echo     "\n Default valueretrieval snmp_set_quick_print(0) " ;
    snmp_set_valueretrieval(SNMP_VALUE_LIBRARY);
    echo     "\n SNMP_VALUE_LIBRARY " . snmp_get_valueretrieval();
    echo     ", retrieved value " . snmpget($strIP, $strComm, $strOID);
    snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
    echo     "\n SNMP_VALUE_PLAIN " . snmp_get_valueretrieval();
    echo     ", retrieved value " . snmpget($strIP, $strComm, $strOID);
    ?>

    结果
    默认 valueretrieval with snmp_set_quick_print(0)
    snmp_get_valueretrieval = SNMP_VALUE_LIBRARY,
    retrieved value up(1)
    SNMP_VALUE_LIBRARY 0, retrieved value up(1)
    SNMP_VALUE_PLAIN 1, retrieved value 1
    默认 valueretrieval snmp_set_quick_print(0)
    SNMP_VALUE_LIBRARY 0, retrieved value up
    SNMP_VALUE_PLAIN 1, retrieved value 1
    -1
    doug dot manley at gmail dot com
    15 年前
    默认值（如果未调用此函数）为“SNMP_VALUE_LIBRARY”，这似乎是 SNMP 的内置打印方式。

    来自“snmp.c”
    <code>
    static PHP_GINIT_FUNCTION(snmp)
    {
    snmp_globals->valueretrieval = SNMP_VALUE_LIBRARY;
    }
    </code>

    这些的温和描述是
    SNMP_VALUE_LIBRARY: 这类似于一个字符串
    "INTEGER: 42"

    SNMP_VALUE_PLAIN: 这类似于一个字符串
    "42"

    SNMP_VALUE_OBJECT: 这类似于一个 PHP 对象
    object(
    "type" => SNMP_INTEGER,
    "value" => 42,
    )
    这里，"type" 是 SNMP_* 类型之一，这些类型在 "预定义常量" 页面中列出。另外，类型 128、129 和 130 是错误条件。
    -1
    david at eder dot us
    20 年前
    看来，此函数的可能方法常量是

    SNMP_VALUE_LIBRARY
    SNMP_VALUE_PLAIN
    SNMP_VALUE_OBJECT

    如果你正在收集数据，你可能需要 SNMP_VALUE_PLAIN。
    ＋添加笔记
    To Top