(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)
|
timeout
El número de microsegundos antes del primer tiempo límite.
retries
El 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";
?>
El resultado del ejemplo sería algo similar a:
STRING: Test server