Edit Report a Bug

    SNMP::get

    (PHP 5 >= 5.4.0, PHP 7, PHP 8)

    SNMP::get — Fetch an SNMP object

    Beschreibung

    public SNMP::get(array|string $objectId, bool $preserveKeys = false): mixed

    Fetch an SNMP object specified in objectId using GET query.

    Parameter-Liste

    If objectId is a string, then SNMP::get() will return SNMP object as string. If objectId is a array, all requested SNMP objects will be returned as associative array of the SNMP object ids and their values.

    objectId

    The SNMP object (OID) or objects

    preserveKeys

    When objectId is a array and preserveKeys set to true keys in results will be taken exactly as in objectId, otherwise SNMP::oid_output_format property is used to determinate the form of keys.

    Rückgabewerte

    Returns SNMP objects requested as string or array depending on objectId type or false on error.

    Fehler/Exceptions

    Diese Methode löst standardmäßig keine Exceptions aus. Um das Auslösen einer SNMPException-Exception beim Auftreten bestimmter Bibliotheksfehler zu aktivieren, muss muss der SNMP-Klassenparameter exceptions_enabled auf einen entsprechenden Wert gesetzt werden. Siehe SNMP::$exceptions_enabled explanation für weitere Details.

    Beispiele

    Beispiel #1 Single SNMP object

    Single SNMP object may be requested in two ways: as string resulting string return value or as single-element array with associative array as output.

    <?php
    $session     = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
    $sysdescr = $session->get("sysDescr.0");
    echo     "$sysdescr\n";
    $sysdescr = $session->get(array("sysDescr.0"));
    print_r($sysdescr);
    ?>

    Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    STRING: Test server
Array
(
    [SNMPv2-MIB::sysDescr.0] => STRING: Test server
)

    Beispiel #2 Multiple SNMP objects

    $session = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
    $results = $session->get(array("sysDescr.0", "sysName.0"));
    print_r($results);
    $session->close();

    Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Array
(
    [SNMPv2-MIB::sysDescr.0] => STRING: Test server
    [SNMPv2-MIB::sysName.0] => STRING: myhost.nodomain
)

    Siehe auch

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top