Edit Report a Bug

    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 and 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, смотрите константы
    // [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, смотрите константы
    // [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, смотрите константы
    // [value] => STRING: lo
    // )

    ?>

    Смотрите также

    add a note add a note

    User Contributed Notes 3 notes

    up
    1
    Mikhail D
    17 years ago
    Sample is swow Interface status.
    (.iso.org.dod.internet.mgmt.mib-2.
    interfaces.ifTable.ifEntry.ifAdminStatus)
    Possible values for this request from MIB:
    Enum(integer): up (1), down (2), testing (3)

    <?php
    //snmp_set_quick_print(0);  // is default
    $strIP = "10.1.1.1"; $strComm = "public";
    $strOID =  ".1.3.6.1.2.1.2.2.1.7.1";
    echo     "\n Default 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); 
    ?>

    Results:
    Default 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
    Default valueretrieval snmp_set_quick_print(0)
    SNMP_VALUE_LIBRARY 0, retrieved value up
    SNMP_VALUE_PLAIN 1, retrieved value 1
    up
    -1
    doug dot manley at gmail dot com
    15 years ago
    The default value (if this function is not called) is "SNMP_VALUE_LIBRARY", which seems to be SNMP's built-in way of printing things.

    From "snmp.c":
    <code>
    static PHP_GINIT_FUNCTION(snmp)
    {
        snmp_globals->valueretrieval = SNMP_VALUE_LIBRARY;
    }
    </code>

    A mild description of these is:
    SNMP_VALUE_LIBRARY: This is a string similar to:
    "INTEGER: 42"

    SNMP_VALUE_PLAIN: This is a string similar to:
    "42"

    SNMP_VALUE_OBJECT: This is a PHP object like:
    object(
    "type" => SNMP_INTEGER,
    "value" => 42,
    )
    Here, "type" is one of the SNMP_* types that are listed under the "Predefined Constants" page.  In addition, types 128, 129, and 130 are error conditions.
    up
    -1
    david at eder dot us
    20 years ago
    It appears that the possible method constants for this function are:

    SNMP_VALUE_LIBRARY
    SNMP_VALUE_PLAIN
    SNMP_VALUE_OBJECT

    If you are harvesting data you probably want SNMP_VALUE_PLAIN.
    add a note add a note
    To Top