snmpget

(PHP 4, PHP 5, PHP 7, PHP 8)

snmpget — Fetch an SNMP object

Description

snmpget(
    string $hostname,
    string $community,
    array|string $object_id,
    int $timeout = -1,
    int $retries = -1
): mixed

The snmpget() function is used to read the value of an SNMP object specified by the object_id.

Parameters

hostname
The SNMP agent.
community
The read community.
object_id
The SNMP object.
timeout
The number of microseconds until the first timeout.
retries
The number of times to retry if timeouts occur.

Return Values

Returns SNMP object value on success or false on error.

Changelog

Version Description
8.5.0 Now throws a ValueError when the hostname length is equal to or greater than 128 bytes, when the port is negative or greater than 65535, or when the timeout or retries values are lower than -1 or too large.

Examples

Example #1 Using snmpget()

<?php
$syscontact = snmpget("127.0.0.1", "public", "system.SysContact.0");
?>

See Also

  • snmpset() - Set the value of an SNMP object