2017 © Pedro PelĂĄez
 

library qdatastream

Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)

image

clue/qdatastream

Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)

  • Saturday, June 9, 2018
  • by clue
  • Repository
  • 1 Watchers
  • 2 Stars
  • 728 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 1 Forks
  • 0 Open issues
  • 11 Versions
  • 14 % Grown

The README.md

clue/qdatastream

CI status installs on Packagist, (*1)

Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream), (*2)

Table of contents, (*3)

Usage

Writer

The Writer class can be used to build a binary buffer string from the structured data you write to it., (*4)

$user = new stdClass;
$user->id = 10;
$user->active = true;
$user->name = 'Alice';

$writer = new Writer();
$writer->writeUInt($user->id);
$writer->writeBool($user->active);
$writer->writeQString($user->name);

$data = (string)$writer
file_put_contents('user.dat', $data);

See the class outline for more details., (*5)

Reader

The Reader class can be used to read data from a binary buffer string., (*6)

$data = file_get_contents('user.dat');
$reader = new Reader($data);

$user = new stdClass();
$user->id = $reader->readUInt();
$user->active = $reader->readBool();
$user->name = $reader->readQString();

See the class outline for more details., (*7)

QVariant

The QVariant class can be used to encapsulate any kind of data with an explicit data type. When writing a QVariant to a buffer, it will also include its data type so that reading it back in can be done automatically without having to know the data type in advance., (*8)

$variant = new QVariant(100, Types::TYPE_USHORT);

$writer = new Writer();
$writer->writeQVariant($variant);

$data = (string)$writer;
$reader = new Reader($data);
$value = $reader->readQVariant();

assert($value === 100);

Additionally, you can use the writeQVariant() method without having to specify the data type in advance and let this class "guess" an appropriate data type for serialization and add this type information to the serialized data. This works similar to JSON encoding and accepts primitive values of type int, bool, string, null and nested structures or type array or instances of stdClass:, (*9)

$rows = [
    (object)[
        'id' => 10,
        'name' => 'Alice',
        'active' => true,
        'groups' => ['admin', 'staff']
    ]
];

$writer = new Writer();
$writer->writeQVariant($rows);

$data = (string)$writer;
$reader = new Reader($data);
$values = $reader->readQVariant();

assert(count($values) === 1);
assert($values[0]->id === 10);
assert($values[0]->groups[0] === 'admin');

Note that associative arrays and stdClass objects be will serialized as a "map", while vector arrays will be serialized as a "list". In order to avoid confusion between these similar data structures, using instances of stdClass is considered the preferred method in this project., (*10)

See the class outline for more details., (*11)

Types

The Types class exists to work with different data types and offers a number of public constants to work with explicit data types and is otherwise mostly used internally only., (*12)

See the class outline for more details., (*13)

Install

The recommended way to install this library is through Composer. New to Composer?, (*14)

This will install the latest supported version:, (*15)

$ composer require clue/qdatastream:^0.8

See also the CHANGELOG for details about version upgrades., (*16)

This project aims to run on any platform and thus does not require any PHP extensions and supports running on legacy PHP 5.3 through current PHP 8+. It's highly recommended to use PHP 7+ for this project., (*17)

The QString and QChar types use the ext-mbstring for converting between different character encodings. If this extension is missing, then this library will use a slighty slower Regex work-around that should otherwise work equally well. Installing ext-mbstring is highly recommended., (*18)

Tests

To run the test suite, you first need to clone this repo and then install all dependencies through Composer:, (*19)

$ composer install

To run the test suite, go to the project root and run:, (*20)

$ php vendor/bin/phpunit

License

This project is released under the permissive MIT license., (*21)

Did you know that I offer custom development services and issuing invoices for sponsorships of releases and for contributions? Contact me (@clue) for details., (*22)

The Versions

09/06 2018

dev-master

9999999-dev https://github.com/clue/php-qdatastream

Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)

  Sources   Download

MIT

The Requires

  • php >=5.3

 

The Development Requires

by Christian LĂŒck

serialize parse binary qt qdatastream

09/06 2018

v0.7.3

0.7.3.0 https://github.com/clue/php-qdatastream

Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)

  Sources   Download

MIT

The Requires

  • php >=5.3

 

The Development Requires

by Christian LĂŒck

serialize parse binary qt qdatastream

29/05 2018

v0.7.2

0.7.2.0 https://github.com/clue/php-qdatastream

Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)

  Sources   Download

MIT

The Requires

  • php >=5.3

 

The Development Requires

by Christian LĂŒck

serialize parse binary qt qdatastream

05/10 2017

v0.7.1

0.7.1.0 https://github.com/clue/php-qdatastream

Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)

  Sources   Download

MIT

The Requires

  • php >=5.3

 

The Development Requires

by Christian LĂŒck

serialize parse binary qt qdatastream

28/09 2017

v0.7.0

0.7.0.0 https://github.com/clue/php-qdatastream

Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)

  Sources   Download

MIT

The Requires

  • php >=5.3

 

The Development Requires

by Christian LĂŒck

serialize parse binary qt qdatastream

24/09 2016

v0.6.0

0.6.0.0 https://github.com/clue/php-qdatastream

Access Qt's QDataStream in PHP

  Sources   Download

MIT

The Requires

 

by Christian LĂŒck

serialize binary qt qdatastream

14/05 2015

v0.5.0

0.5.0.0 https://github.com/clue/php-qdatastream

Access Qt's QDataStream in PHP

  Sources   Download

MIT

The Requires

 

by Christian LĂŒck

serialize binary qt qdatastream

12/05 2015

v0.4.0

0.4.0.0 https://github.com/clue/php-qdatastream

Access Qt's QDataStream in PHP

  Sources   Download

MIT

The Requires

 

by Christian LĂŒck

serialize binary qt qdatastream

10/05 2015

v0.3.0

0.3.0.0 https://github.com/clue/php-qdatastream

Access Qt's QDataStream in PHP

  Sources   Download

MIT

The Requires

 

by Christian LĂŒck

serialize binary qt qdatastream

01/05 2015

v0.2.0

0.2.0.0 https://github.com/clue/php-qdatastream

Access Qt's QDataStream in PHP

  Sources   Download

MIT

The Requires

 

by Christian LĂŒck

serialize binary qt qdatastream

28/04 2015

v0.1.0

0.1.0.0 https://github.com/clue/php-qdatastream

Access Qt's QDataStream in PHP

  Sources   Download

MIT

The Requires

 

by Christian LĂŒck

serialize binary qt qdatastream