Download the PHP package juanchosl/datatransfer without Composer

DataTransfer

Description

A small, lightweight utility to read values and properties from distinct sources using the same methodology and convert it to a standard DTO. Include a second tool that can convert any of DTOs to any of the know formats, creating a simple format converter from format A to format B.

Install

How use it

Load composer autoload and use it

Data Transfer Objects

Using the provided Factory

The $element parameter can be:

• array indexed or associtive
• object that implements JsonSerializable interface
• string with serialized object or array
• filepath containing a serialized object or array
• json encoded object or array
• json filepath with json extension containing a json encoded object or array
• SimpleXMLElement object
• XML string or filepath with xml extension
• CSV filepath with csv extension (for CSV contents string, use the byString method and indicate the Format)
• INI filepath with ini extension (for INI contents string, use the byString method and indicate the Format)
• YAML filepath with yml or yaml extension (for YAML contents string, use the byString method and indicate the Format) (require yaml php extension)
• primitive value

Magic CREATE method

Today is not possible detect a INI, YAML or CSV string, can use filepath with the rigth extension, but not this string types

Using a filepath

Open and convert the contents included into file, alternatively you can specify the Format if the extension is not knowed

Using a string

Detect and convert the contents included into string (json encoded, serialized object or array, xml), alternatively you can specify the Format if the type is YAML, CSV or INI

Using a trasversable element

Detect and convert the trasversable element (object or array)

Using a specific repository

Alternative you can use the distincts repositories

Available origins and repositories

The $element parameter needs to be the required type for the selected repo

Is more efective use a magic factory in order to avoid know the type of the original data, and you can change it with no need to adapt your existing code.

The resultant $dto variable is a recursive data transfer object, iterable, countable, clonable and json serializable

Use data

TODO

When we need to use a CSV, YAML or INI contents to transform to a DTO, we need to use the native DataTransfer, today is not possible detect it as distinct of string or array

Data Converters

You can convert any DataTransferObject to a standar format, as:

• array
• json
• xml
• SimpleXMLElement
• stdClass
• ini
• yaml
• csv
• excel csv

Using the provided Factory

Using a specific converter

Alternative you can use the distincts converters

The available converters are:

• ArrayConverter
• CsvConverter (,) or ExcelCsvConverter(;)
• JsonConverter
• ObjectConverter
• XmlConverter
• XmlObjectConverter
• CsvConverter
• YamlConverter
• IniConverter