array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'snmp.get.php', 1 => 'SNMP::get', 2 => 'Recupera un objeto SNMP', ), 'up' => array ( 0 => 'class.snmp.php', 1 => 'SNMP', ), 'prev' => array ( 0 => 'snmp.construct.php', 1 => 'SNMP::__construct', ), 'next' => array ( 0 => 'snmp.geterrno.php', 1 => 'SNMP::getErrno', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/snmp/snmp/get.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SNMP::get

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

SNMP::get — Recupera un objeto SNMP

Descripción

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

Recupera un objeto SNMP especificado por el identificador objectId utilizando una solicitud GET.

Parámetros

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.

objectId
El 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.

Valores devueltos

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.

Errores/Excepciones

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.

Ejemplos

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
)

Ver también