botanick/serializer

Library for serialization of any PHP structures (scalars, objects, arrays, etc.) into PHP primitives (scalars, arrays of scalars, arrays of arrays).

Maintainers

Details

github.com/Botanick/serializer

Homepage

Source

Issues

Installs: 161

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

dev-master / 1.0.x-dev 2018-02-11 08:19 UTC

Requires

Requires (Dev)

Apache-2.0 89dc220e9554e6e21f76af6e2b7f6bf05074067f

serializationarrayobjectstructure

This package is not auto-updated.

Last update: 2024-04-11 14:37:12 UTC

README

Build Status

This library allows you to serialize PHP structures of any complexity into PHP primitives: scalars, arrays, arrays of scalars, arrays of arrays, etc. The result can be then safely stored somewhere or passed anywhere using serialize(), json_encode() or any other way to convert plain arrays into string.

This library contains built-in serializers for:

  • null
  • scalars (bool, int, float, string)
  • PHP resource type
  • arrays and \Traversable
  • \DateTime
  • objects (which are flexibly configurable via custom configurations)

Installation

This library is managed via composer. You can install it by calling:

$ composer require botanick/serializer

or manually adding it to your composer.json:

    "require": {
        "botanick/serializer": "dev-master"
    }

Usage

Serializer usage is split into two general steps.

First of all, you should construct data serializers you are going to use. For example, if you are going to serialize only arrays of DateTimes, then your code will look like:

use Botanick\Serializer\Serializer;

$arraySerializer = new Serializer\DataSerializer\ArraySerializer();
$dateTimeSerializer = new Serializer\DataSerializer\DateTimeSerializer();
// for detailed info on DateTimeSerializer options see an according section
$dateTimeSerializer->setDefaultOptions(array('format' => 'Y-m-d H:i:s'));

Then you need serializer to know about data serializers it should use:

use Botanick\Serializer\Serializer;

$serializer = new Serializer\Serializer();
$serializer->addDataSerializer($arraySerializer, -9999);
$serializer->addDataSerializer($dateTimeSerializer, -8888);

That's all! Now you are able to serialize your data:

$data = array(
    new \DateTime(),
    'yesterday' => new \DateTime('1 day ago'),
    'dates' => array(
        'some-date' => \DateTime::createFromFormat('H:i:s d.m.Y', '11:22:33 01.02.2003'),
        'another-date' => \DateTime::createFromFormat('d.m.Y', '01.02.2003')
    )
);
$serializedData = $serializer->serialize($data);
var_export($serializedData);

// you will see something like this:
// array (
//   0 => '2015-12-08 16:42:54',
//   'yesterday' => '2015-12-07 16:42:54',
//   'dates' => 
//   array (
//     'some-date' => '2003-02-01 11:22:33',
//     'another-date' => '2003-02-01 16:42:54',
//   ),
// )

Documentation