array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'snmp.construct.php', 1 => 'SNMP::__construct', 2 => 'Crea una instancia SNMP que representa la sesión con el agente remoto SNMP', ), 'up' => array ( 0 => 'class.snmp.php', 1 => 'SNMP', ), 'prev' => array ( 0 => 'snmp.close.php', 1 => 'SNMP::close', ), 'next' => array ( 0 => 'snmp.get.php', 1 => 'SNMP::get', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/snmp/snmp/construct.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

?>

Resultado del ejemplo anterior es similar a:

STRING: Test server

Ver también