Documentación offline PHP master

snmp3_walk

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

En esta página

snmp3_walk

Recupera todos los objetos

SNMP

desde un agente

Descripción#

snmp3_walk(string $hostname, string $security_name, string $security_level, string $auth_protocol, string $auth_passphrase, string $privacy_protocol, string $privacy_passphrase, array $object_id, [int $timeout], [int $retries]): array
```php

La función `snmp3_walk` se utiliza para leer todos los valores desde un agente SNMP especificado por el parámetro `host`.

Aunque el nivel de seguridad no utilice un protocolo de autenticación, se deben especificar valores válidos.

## Parámetros

`hostname`  
El nombre del host del agente SNMP (servidor).

`security_name`  
El nombre de la seguridad, habitualmente, el nombre del usuario.

`security_level`  
El nivel de seguridad (noAuthNoPriv\|authNoPriv\|authPriv).

`auth_protocol`  
El protocolo de autenticación (`"MD5"`, `"SHA"`, `"SHA256"` o `"SHA512"`).

`auth_passphrase`  
La frase secreta de autenticación.

`privacy_protocol`  
El protocolo privado (DES o AES).

`privacy_passphrase`  
La frase secreta privada.

`object_id`  
Si vale `null`, `object_id` será la raíz del árbol de objetos SNMP y todos los objetos subyacentes se devuelven en forma de array.

Si `object_id` está especificado, todos los objetos SNMP bajo el objeto `object_id` serán devueltos.

`timeout`  
El número de microsegundos antes del primer tiempo límite.

`retries`  
El número de intentos en caso de que ocurra el tiempo límite.

## Valores devueltos

Devuelve un array de valores de objetos SNMP comenzando desde el objeto `object_id` como raíz, o `false` si ocurre un error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `auth_protocol` acepta ahora `"SHA256"` y `"SHA512"` cuando es soportado por libnetsnmp. |

## Ejemplos

Ejemplo con `snmp3_walk`

```php

La llamada a la función anterior devolverá todos los objetos SNMP desde el agente SNMP ejecutándose en localhost: array ( 0 => 'STRING: lo', 1 => 'STRING: eth0', 2 => 'STRING: eth2', 3 => 'STRING: sit0', 4 => 'STRING: sixxs', )

Véase también#

snmp3_real_walk