(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SNMP::get — Busca um objeto SNMP
Busca um objeto SNMP especificado em
objectId
usando uma consulta GET.
Se objectId
for uma string, então SNMP::get()
retornará o objeto SNMP como string. Se
objectId
for um array, todos os objetos SNMP
solicitados serão retornados como um array associativo dos IDs dos objetos SNMP e seus
valores.
objectId
O objeto SNMP (OID) ou objetos
preserveKeys
Quando objectId
é um array e
preserveKeys
definido como true
as chaves nos resultados
serão obtidas exatamente como em objectId
,
caso contrário, a propriedade SNMP::oid_output_format é usada para determinar
o formato das chaves.
Retorna objetos SNMP solicitados como string ou array
dependendo do tipo objectId
ou false
em caso de erro.
Esse método não lança nenhuma exceção por padrão.
Para habilitar o lançamento de exceções SNMPException quando ocorrer algum dos erros da biblioteca,
o parâmetro exceptions_enabled
da classe SNMP
deve ser definido com um valor correspondente. Consulte a
explicação sobre SNMP::$exceptions_enabled
para mais detalhes.
Exemplo #1 Objeto SNMP único
Um único objeto SNMP pode ser solicitado de duas maneiras: como string (valor de retorno da string resultante) ou como um array de elemento único (com array associativo como saída).
<?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 produzirá algo semelhante a:
STRING: Test server Array ( [SNMPv2-MIB::sysDescr.0] => STRING: Test server )
Exemplo #2 Vários objetos 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();
O exemplo acima produzirá algo semelhante a:
Array ( [SNMPv2-MIB::sysDescr.0] => STRING: Test server [SNMPv2-MIB::sysName.0] => STRING: myhost.nodomain )