lemonblast/cbor4php

CBOR encoder/decoder for PHP

Cbor4Php

CBOR (Concise Binary Object Representation) is a tiny data format that can be used in place of JSON. Cbor4Php is a simple CBOR encoder/decoder for PHP., _(*1)

Installation

To install the library through composer, you simply need to add the following to composer.json and run composer update or composer install:, _(*2)

{
    "require": {
       "lemonblast/cbor4php": "dev-master"
    }
}

Once installed, you can use the Cbor class (Lemonblast\Cbor4Php\Cbor) to encode and decode CBOR data., _(*3)

Usage

Include the Cbor4Php library in your source:, _(*4)

use Lemonblast\Cbor4Php\Cbor;

Encoding

To encode a variable into a CBOR byte string call the encode method and pass the value as a parameter:, _(*5)

$foo = Cbor::encode($bar);

Encoding an object will convert it to an associative array, and encode it as such. Only public fields will be encoded., _(*6)

Encoding a PHP resource is not supported and will result in a null return value., _(*7)

Decoding

To decode a CBOR byte string into a PHP variable:, _(*8)

$bar = Cbor::decode($foo);

CBOR data tags are ignored during the decode process. Decoding a null value or empty string will result in a null return value., _(*9)

Testing

To run unit tests, simply clone this repository and run composer install followed by php vendor/bin/phpunit in the project directory., _(*10)