(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SNMP::__construct — Crea una instancia SNMP que representa la sesión con el agente remoto SNMP
$version,$hostname,$community,$timeout = -1,$retries = -1Crea una instancia SNMP que representa una sesión con un agente SNMP remoto.
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)
|
timeoutEl número de microsegundos antes del primer tiempo límite.
retriesEl número de intentos cuando ocurre un tiempo límite.
SNMP::__construct() lanza una excepción cuando los parámetros son incorrectos o la versión del protocolo SNMP es desconocida.
Ejemplo #1 Recuperación de la ubicación física del host
<?php
$session = new SNMP(SNMP_VERSION_1, "127.0.0.1", "public");
$sysdescr = $session->get("sysDescr.0");
echo "$sysdescr\n";
?>Resultado del ejemplo anterior es similar a:
STRING: Test server