dface/snmp-packet

SNMP packets encoder/decoder

dev-master 2018-01-03 15:03 UTC

Requires

• php: >=7.1
• infection/infection: dev-master
• sop/asn1: dev-master

Requires (Dev)

• phpunit/phpunit: ^6.4

MIT

• Denis Ponomarev

• encoder
• message
• decoder
• snmp
• packet

README

SnmpPacket

Note: This is an early development version.

A PHP library to encode/decode SNMP packets.

This library does not aim to implement SNMP protocol processing. It's just for decoding SNMP messages from binary strings into PHP-objects and vice versa.

Supports SNMP messages v1, v2c and v3.

Installation

composer require dface/snmp-packet

Usage

Example of naive snmpget command can be found in ./examples/NaiveSnmpGet.php. Take a look at prepareRequest() to see how to construct/encode messages. And processResponse() to see how to decode/process them.

Simple example of message encoding:

// construct pdu:
$bindings = new VarBindList(
   new VarBind(new Oid('1.3.6.1.2.1.1.3.0'), new NullValue())
); 
$pdu = new GetRequestPDU(1, 0, 0, $bindings);

// pack into the message:
$message = new MessageV1(1, $this->community, $pdu);

// take a binary to send it somewhere:
$bin = $message->toBinary();

Simple example of message decoding:

// decode message from binary:
$message = MessageV1::fromBinary($bin);

// take pdu:
$pdu = $message->getPdu();

//check on errors:
$err = $pdu->getErrorStatus();

// iterate over bindings:
$bindings = $pdu->getVariableBindings()->getList();
foreach ($bindings as $var_bind) {
    printf("%s: %s\n", $var_bind->getOid(), $var_bind->getValue());
}