PHP Conference Kansai 2025

SNMP::__construct

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SNMP::__constructCrea 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 = -1,
    int $retries = -1
)

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 defecto127.0.0.1
IPv6 con puerto por defecto::1 o [::1]
IPv4 con puerto específico127.0.0.1:1161
IPv6 con puerto específico[::1]:1161
FQDN con puerto por defectohost.domain
FQDN con puerto específicohost.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

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

Ver también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top