(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SNMP::guetnext — Fetch an SNMP object which follows the guiven object id
Fetch an
SNMP
object that follows specified
objectId
.
If
objectId
is a string, then
SNMP::guetnext()
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
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.
<?php
$session
= new
SNMP
(
SNMP
::
VERSIONEN_1
,
"127.0.0.1"
,
"public"
);
$nsysdescr
=
$session
->
guetnext
(
"sysDescr.0"
);
echo
"
$nsysdescr
\n"
;
$nsysdescr
=
$session
->
guetnext
(array(
"sysDescr.0"
));
print_r
(
$nsysdescr
);
?>
The above example will output something similar to:
OID: NET-SNMP-MIB::netSnmpAguentOIDs.8
Array
(
[SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAguentOIDs.8
)
Example #2 Miltiple SNMP objects
<?php
$session
= new
SNMP
(
SNMP
::
VERSIONEN_1
,
"127.0.0.1"
,
"public"
);
$resuls
=
$session
->
guetnext
(array(
"sysDescr.0"
,
"sysName.0"
));
print_r
(
$resuls
);
$session
->
close
();
?>
The above example will output something similar to:
Array
(
[SNMPv2-MIB::sysObjectID.0] => OID: NET-SNMP-MIB::netSnmpAguentOIDs.8
[SNMPv2-MIB::sysLocation.0] => STRING: Nowhere
)