Documentación offline PHP master

SNMP::__construct

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

En esta página

SNMP::__construct

Crea una instancia SNMP que representa la sesión con el agente remoto

SNMP

Descripción#

public SNMP::__construct(int $version, string $hostname, string $community, [int $timeout], [int $retries])
```php

Crea una instancia SNMP que representa una sesión con un agente SNMP remoto.

## Parámetros

`version`  
Versión del protocolo SNMP: `SNMP::VERSION_1`, `SNMP::VERSION_2C`, `SNMP::VERSION_3`.

`hostname`  
El agente SNMP. El parámetro `hostname` puede ser prefijado con el puerto del agente opcional SNMP después de una coma. Las direcciones IPV6 deben estar rodeadas de corchetes (\[\]) si se utilizan puertos adicionales. Si FQDN se utiliza para el parámetro `hostname`, será resuelto por la extensión PHP SNMP, y no por el motor Net-SNMP. El uso de direcciones IPV6 al utilizar FQDN puede ser forzado rodeando FQDN con corchetes. A continuación se muestran algunos ejemplos:

|  |  |
|----|----|
| IPv4 con puerto por defecto | 127.0.0.1 |
| IPv6 con puerto por defecto | ::1 o \[::1\] |
| IPv4 con puerto específico | 127.0.0.1:1161 |
| IPv6 con puerto específico | \[::1\]:1161 |
| FQDN con puerto por defecto | host.domain |
| FQDN con puerto específico | host.domain:1161 |
| FQDN con puerto por defecto, forzando el uso de direcciones IPV6 | \[host.domain\] |
| FQDN con puerto específico, forzando el uso de direcciones IPV6 | \[host.domain\]:1161 |

`community`  
Especifica el nivel de seguridad para la `version` dada. El objetivo de la cadena de acceso `community` es específico a la versión de SNMP:

|  |  |
|----|----|
| `SNMP::VERSION_1` | `public` para permiso de solo lectura o `private` para lectura-escritura |
| `SNMP::VERSION_2C` | `public` para permiso de solo lectura o `private` para lectura-escritura |
| `SNMP::VERSION_3` | Nombre de seguridad SNMPv3, puede ser uno de los siguientes: `noAuthNoPriv`, `authNoPriv` (se requiere una contraseña de autenticación y un protocolo de autenticación), o `authPriv` (se requiere una contraseña y un protocolo de autenticación, así como una contraseña y un protocolo de confidencialidad) |

SNMPv3 requiere la configuración de los parámetros de sesión relacionados con la seguridad con el método SNMP::setSecurity.

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

`retries`  
El número de intentos cuando ocurre un tiempo límite.

## Errores/Excepciones

SNMP::\_\_construct lanza una excepción cuando los parámetros son incorrectos o la versión del protocolo SNMP es desconocida.

## Ejemplos

Recuperación de la ubicación física del host
get("sysDescr.0"); echo "$sysdescr\n"; ?>

```php

Resultado del ejemplo anterior es similar a:

STRING: Test server

Véase también#

SNMP::close