SNMP::get

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SNMP::getBusca um objeto SNMP

Descrição

public SNMP::get(array|string $objectId, bool $preserveKeys = false): mixed

Busca um objeto SNMP especificado em objectId usando uma consulta GET.

Parâmetros

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.

Valor Retornado

Retorna objetos SNMP solicitados como string ou array dependendo do tipo objectId ou false em caso de erro.

Erros/Exceções

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.

Exemplos

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
)

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top