array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'snmp.construct.php', 1 => 'SNMP::__construct', 2 => 'Cria uma instância SNMP representando a sessão para o agente SNMP remoto', ), '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' => 'pt_BR', '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 — Cria uma instância SNMP representando a sessão para o agente SNMP remoto

Descrição

public SNMP::__construct(
    int $version,
    string $hostname,
    string $community,
    int $timeout = -1,
    int $retries = -1
)

Cria uma instância SNMP representando a sessão para o agente SNMP remoto.

Parâmetros

version
Versão de protocolo SNMP: SNMP::VERSION_1, SNMP::VERSION_2C, SNMP::VERSION_3.
hostname

O agente SNMP. hostname pode ser sufixado com porta de agente SNMP opcional após dois pontos. Endereços IPv6 devem ser colocados entre colchetes se usados ​​com porta. Se FQDN for usado para hostname ele será resolvido pela extensão SNMP do PHP, não pelo mecanismo Net-SNMP. O uso de endereços IPv6 ao especificar FQDN pode ser forçado colocando FQDN entre colchetes. Aqui estão alguns exemplos:
IPv4 com porta padrão127.0.0.1
IPv6 com porta padrão::1 ou [::1]
IPv4 com porta específica127.0.0.1:1161
IPv6 com porta específica[::1]:1161
FQDN com porta padrãohost.domain
FQDN com porta específicahost.domain:1161
FQDN com porta padrão, força uso de endereço IPv6[host.domain]
FQDN com porta específica, força uso de endereço IPv6[host.domain]:1161

community
Especifica o nível de segurança para a versão informada no parâmetro version. A finalidade da string de acesso community é específica da versão SNMP:
SNMP::VERSION_1 public para permissão somente leitura ou private para leitura e gravação
SNMP::VERSION_2C public para permissão somente leitura ou private para leitura e gravação
SNMP::VERSION_3 Nome de segurança SNMPv3, pode ser: noAuthNoPriv, authNoPriv (requer uma senha e um protocolo de autenticação) ou authPriv (requer uma senha e um protocolo de autenticação, e também um senha e um protocolo de privacidade)
O SNMPv3 requer a configuração de parâmetros de sessão relacionados à segurança com o método SNMP::setSecurity().
timeout
O número de microssegundos até o primeiro tempo limite.
retries
O número de tentativas caso o tempo limite seja atingido.

Erros/Exceções

SNMP::__construct() lança uma exceção quando a contagem de parâmetros ou os tipos estiverem incorretos ou desconhecidos ou a versão do protocolo SNMP especificada for desconhecida.

Exemplos

Exemplo #1 Buscando a localização física do host

<?php

$session = new SNMP(SNMP::VERSION_1, "127.0.0.1", "public");
$sysdescr = $session->get("sysDescr.0");
echo "$sysdescr\n";

?>

O exemplo acima produzirá algo semelhante a:

STRING: Test server

Veja Também