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

SNMP::getFetch an SNMP object


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

Fetch an SNMP object specified in objectId using GET query.


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.


The SNMP object (OID) or objects


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.

Return Values

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


This method does not throw any exceptions by default. To enable throwing an SNMPException exception when some of library errors occur the SNMP class parameter exceptions_enabled should be set to a corresponding value. See SNMP::$exceptions_enabled explanation for more details.


Example #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.

= new SNMP(SNMP::VERSION_1, "", "public");
$sysdescr = $session->get("sysDescr.0");
$sysdescr = $session->get(array("sysDescr.0"));

The above example will output something similar to:

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

Example #2 Multiple SNMP objects

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

The above example will output something similar to:

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

See Also

add a note

User Contributed Notes

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