Documentación offline PHP master

SNMP::get

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

SNMP::get

Recupera un objeto

SNMP

Descripción#

public SNMP::get(array $objectId, [bool $preserveKeys]): mixed
```php

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 defecto. Para activar el lanzamiento de excepciones SNMPException cuando ocurren errores de la biblioteca, el parámetro de la clase SNMP `exceptions_enabled` ebe ser definido al valor correspondiente. Ver las [ explicaciones sobre `SNMP::$exceptions_enabled`](#snmp.props.exceptions-enabled) para más detalles.

## Ejemplos

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.
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
    )

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();

```php

Resultado del ejemplo anterior es similar a:

Array
(
    [SNMPv2-MIB::sysDescr.0] => STRING: Test server
    [SNMPv2-MIB::sysName.0] => STRING: myhost.nodomain
)

Véase también#

SNMP::getErrno

SNMP::getError