SNMP::__construct

(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

Descripción

public function 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 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

La cadena de comunidad o, para SNMP::VERSION_3, el nombre de seguridad. 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`	El nombre de seguridad, habitualmente algún tipo de nombre de usuario.

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";

?>

Resultado del ejemplo anterior es similar a:

STRING: Test server

Véase también

SNMP::close() - Cerrar sesión SNMP

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.