SNMP::get

Fetch an SNMP object

&reftitle.description; public `mixed` `SNMP::get` ``array``string```objectId` `bool` `preserveKeys`&false;

Fetch an SNMP object specified in `objectId` using GET query.

&reftitle.parameters;

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.

&reftitle.returnvalues;

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

&snmp.methods.exceptions_enable.refsect;
&reftitle.examples;

### 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);
    ?>

&example.outputs.similar;

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

### 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();

&example.outputs.similar;

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

&reftitle.seealso;

- `SNMP::getErrno`
- `SNMP::getError`