Download the PHP package earc/serializer without Composer

earc/serializer

Standalone lightweight extendable serializer component of the eArc libraries.

Although it's a small library, it is very powerful. With just a few lines of code you can use it to import entities from csv or map them to a bunch of sql-tables.

table of contents

• installation
• basic usage
• advanced usage
  • filtering properties
  • customizing serialization via specialized data types
  • data mapping
• releases
  • release v1.1
  • release v1.0
  • release v0.1
  • release v0.0

installation

Install the earc serializer library via composer.

basic usage

First enable the earc/di dependency injection component.

Now your ready to serialize some content.

$value is the same as $deserializedValue.

The data types DateTime, object, array, string, int,float, bool and null values are supported by the default serialization type out of the box.

Even serialization of recursive object structures are possible.

This outputs:

{"type":"X","value":{"content":{"referenceToY":{"type":"Y","value":{"content":{"referenceToX":{"type":"X","value":{"content":null,"id":57}}},"id":60}}},"id":57}}

$object yields an instance of X referencing an instance of Y having a reference on X. Of course, it is not the same instance as serialized. It's an identical instance like you would receive on cloning the object. If multiple references point to the same instance, this holds also true after deserialization. You can enforce same instances by wrapping multiple objects into an array.

The deserialized value would also hold two references to the same instance of the class Z1.

advanced usage

The basic usage of the earc/serializer is not superior to the native php serialize/unserialize function. You should use the earc/serializer only if you need the advanced features.

filtering properties

The earc/serializer offers an easy way to organize the filtering of properties. Extend the SerializerDefaultType and overwrite the filterProperty() method. Only if this method returns true the property will be serialized.

To use this Filter use an object of the extending class as second argument.

customizing serialization via specialized data types

There are use cases where you need full control over the serialization process. For example in the case of further processing the serialized value or if your object/data needs a special processing prior serialization or post deserialization. Specialized data types offer you this level of control while keeping your architecture clean.

To create your own data type implement the DataTypeInterface.

Hint 1: serialize() can return anything that can be processed by the native php function json_encode(). If it is not an array or does not have the type and value keys the $type parameter will be an empty string and the $value parameter will hold the serialized value.

Hint 2: You can use the FactoryService, SerializeService or the ObjectHashService for specialized tasks.

To use the new data type you need a serializer type referencing the new data type. Either implement the SerializerTypeInterface or extend the SerializerDefaultType and overwrite the getDataTypes() method.

Note the order. If multiple data types are applicable, the data type placed first is applied.

Hint: If you need to build the MyDataType object by another dependency injection system than earc/di you can pass the object instead of null.

To use the new serializer type instead of the default pass its object as second argument to the serializer methods.

Hint: You can use your own dependency injection function (or container) to build the serializer type object.

data mapping

You can use earc/serializer to do all kinds of data mapping, even if tables are involved. This includes mapping (nested) objects to csv or sql and back. Check the examples' folder to get an impression.

releases

release v1.1

• PHP ^8.0 || ^7.4

release v1.0

• data types can be prioritized
• serializer types passed as parameter instead of tagged data types
• filter (whitelist or blacklist) properties

release v0.1

• PHP 7.4
• additional supported data types:
  • DateTime
• serialization of private properties of parents

release v0.0

first official release

• supported data types:
  • object (class instance)
  • object (StdClass)
  • array
  • string
  • float
  • int
  • bool
  • null
• customized data types
• support for serialization of recursive object relations
• easy readable serialized output
• serializing structures:
  • json