SNMP::get
(PHP 5 >= 5.4.0, PHP 7)
SNMP::get — Fetch an SNMP object
Description
Fetch an SNMP object specified in
object_id
using GET query.
Parameters
If object_id
is a string, then SNMP::get()
will return SNMP object as string. If
object_id
is a array, all requested SNMP
objects will be returned as associative array of the SNMP object ids and their
values.
-
object_id
-
The SNMP object (OID) or objects
-
preserve_keys
-
When
object_id
is a array andpreserve_keys
set toTRUE
keys in results will be taken exactly as inobject_id
, 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 object_id
type or FALSE
on error.
Errors/Exceptions
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.
Examples
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.
<?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);
?>
The above example will output something similar to:
STRING: Test server Array ( [SNMPv2-MIB::sysDescr.0] => STRING: Test server )
Example #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();
The above example will output something similar to:
Array ( [SNMPv2-MIB::sysDescr.0] => STRING: Test server [SNMPv2-MIB::sysName.0] => STRING: myhost.nodomain )
English translation
You have asked to visit this site in English. For now, only the interface is translated, but not all the content yet.If you want to help me in translations, your contribution is welcome. All you need to do is register on the site, and send me a message asking me to add you to the group of translators, which will give you the opportunity to translate the pages you want. A link at the bottom of each translated page indicates that you are the translator, and has a link to your profile.
Thank you in advance.
Document created the 30/01/2003, last modified the 26/10/2018
Source of the printed document:https://www.gaudry.be/en/php-rf-snmp.get.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.