(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SNMP::get — 获取 SNMP 对象
使用 GET 查询获取在 objectId
中指定的 SNMP 对象。
如果 objectId
是字符串,则 SNMP::get() 将返回 SNMP 对象作为字符串。如果 objectId
是数组,则所有请求的 SNMP 对象将作为 SNMP 对象 ID 及其值的关联数组返回。
objectId
SNMP 对象 (OID) 或对象
preserveKeys
当 objectId
是数组且 preserveKeys
设置为 true
时,结果中的键将与 objectId
中的键完全相同,否则将使用 SNMP::oid_output_format 属性来确定键的形式。
根据 objectId
类型返回请求的 SNMP 对象作为字符串或数组,或者在出错时返回 false
。
此方法默认不抛出任何异常。要启用在发生某些库错误时抛出 SNMPException 异常,应将 SNMP 类参数 exceptions_enabled
设置为相应的值。有关详细信息,请参阅 SNMP::$exceptions_enabled
说明。
示例 #1 单个 SNMP 对象
单个 SNMP 对象可以通过两种方式请求:作为字符串返回字符串结果,或作为带有关联数组作为输出的单元素数组。
<?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);
?>
以上示例将输出类似于以下内容:
STRING: Test server Array ( [SNMPv2-MIB::sysDescr.0] => STRING: Test server )
示例 #2 多个 SNMP 对象
$session = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
$results = $session->get(array("sysDescr.0", "sysName.0"));
print_r($results);
$session->close();
以上示例将输出类似于以下内容:
Array ( [SNMPv2-MIB::sysDescr.0] => STRING: Test server [SNMPv2-MIB::sysName.0] => STRING: myhost.nodomain )