(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SNMP::get — Recupera un objeto SNMP
Recupera un objeto SNMP especificado por el identificador
objectId utilizando una solicitud GET.
Si objectId es una string, entonces SNMP::get()
devolverá un objeto SNMP en forma de string. Si
objectId es un array, todos los objetos SNMP solicitados
serán devueltos en forma de array asociativo de identificadores de objetos
SNMP y sus valores.
objectIdEl o los objetos SNMP (OID)
preserve_keys
Cuando objectId es un array, y el parámetro
preserve_keys está definido a true, las claves en el resultado
serán tomadas exactamente del objeto objectId, de lo contrario,
la propiedad SNMP::oid_output_format será utilizada para determinar
el formato de las claves.
Devuelve los objetos SNMP solicitados, en forma
de strings o arrays, según el tipo del parámetro
objectId, o false si ocurre un error.
Este método no lanza excepciones por omisión.
Para activar el lanzamiento de excepciones SNMPException cuando
ocurren errores de la biblioteca,
el parámetro de la clase SNMP exceptions_enabled
debe ser definido al valor correspondiente. Ver las
explicaciones sobre SNMP::$exceptions_enabled
para más detalles.
Ejemplo #1 Un solo objeto SNMP
Un solo objeto SNMP puede ser solicitado de 2 maneras: en forma de string, devolviendo así un valor en forma de string también, o un array conteniendo un solo elemento, devolviendo así un array asociativo.
<?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);
?>Resultado del ejemplo anterior es similar a:
STRING: Test server
Array
(
[SNMPv2-MIB::sysDescr.0] => STRING: Test server
)
Ejemplo #2 Varios 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();Resultado del ejemplo anterior es similar a:
Array
(
[SNMPv2-MIB::sysDescr.0] => STRING: Test server
[SNMPv2-MIB::sysName.0] => STRING: myhost.nodomain
)