SNMP::get
(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SNMP::get — Fetch an SNMP object
Descrição
$objectId
, bool $preserveKeys = false
) : array|bool
Fetch an SNMP object specified in
objectId using GET query.
Parâmetros
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
objectIdis a array andpreserveKeysset totruekeys in results will be taken exactly as inobjectId, otherwise SNMP::oid_output_format property is used to determinate the form of keys.
Valor Retornado
Returns SNMP objects requested as string or array
depending on objectId type or false on error.
Erros
Esse método não lança nenhuma exceção por padrão.
Para ativar o lançamento de exceções SNMPException quando algum erro ocorrer,
o parâmetro exceptions_enabled
deve ser configurado. Veja
SNMP::$exceptions_enabledessa explicação para mais detalhes.
Exemplos
Exemplo #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);
?>
O exemplo acima irá imprimir algo similar à:
STRING: Test server
Array
(
[SNMPv2-MIB::sysDescr.0] => STRING: Test server
)
Exemplo #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();
O exemplo acima irá imprimir algo similar à:
Array
(
[SNMPv2-MIB::sysDescr.0] => STRING: Test server
[SNMPv2-MIB::sysName.0] => STRING: myhost.nodomain
)
Veja Também
- SNMP::getErrno() - Get last error code
- SNMP::getError() - Get last error message
add a note
