binn php

Binn

PHP Class for serialize to binary string.

Original C Binn Library: https://github.com/liteserver/binn

Binn Specification: https://github.com/liteserver/binn/blob/master/spec.md

Installation

composer require knik/binn

Examples

Binn

Sequential arrays:

use KnikBinnBinn;

$binn = new Binn();

// List
$array = [123, -456, 789];
$binnString = $binn->serialize($array);
$unserialized = $binn->unserialize($binnString); // Equal with $array

Numeric keys array:

$binn = new Binn();

// Map
$array = [1 => "add", 2 => [-12345, 6789]];
$binnString = $binn->serialize($array);
$unserialized = $binn->unserialize($binnString); // Equal with $array

String keys array:

$binn = new Binn();

// Object
$array = ["hello" => "world"];
$binnString = $binn->serialize($array);
$unserialized = $binn->unserialize($binnString); // Equal with $array

Mixed arrays:

$binn = new Binn();
$array = [ ["id" => 1, "name" => "John"], ["id" => 2, "name" => "Eric"] ]

// A list of objects
$binnString = $binn->serialize($array);
$unserialized = $binn->unserialize($binnString); // Equal with $array

Blob:

$binn = new Binn();
$file = fopen('/path/to/file.jpg', 'rb');

// Filedata in binn structure
$bin1 = $binn->serialize($file);

// Filedata in binn list structure
$bin2 = $binn->serialize(['file' => $file]);

Symfony Serializer

You can use BinnEncoder with Symfony Serializer

use KnikBinnEncoderBinnEncoder;
use SymfonyComponentSerializerSerializer;

$encoders = [new BinnEncoder()];
$serializer = new Serializer([], $encoders);

$serializer->serialize("x40xD0x06", 'binn');

Original C library style

$binn = new BinnList();
$binn->addUint8(4);
$binn->addInt16(-8875);
$binn->addStr('text');

$serialized = $binn->serialize(); // xE0x0Fx03x20x04x41xDDx55xA0x04textx00

Nested arrays

$array = [2, true, [123, -456, 789]];

$binn = new BinnList();

// xE0x11x03x20x02x01xE0x0Bx03x20x7Bx41xFEx38x40x03x15
$serialized = $binn->serialize($array);