Download the PHP package ok/dto-annotation-mapper without Composer

On this page you can find all versions of the php package ok/dto-annotation-mapper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of ok/dto-annotation-mapper

Informations about the package dto-annotation-mapper

Annotation entity mapper based on Doctrine

Latest Stable Version Total Downloads License

This library intended for auto fill entity object from input dataset based on annotations.

Purpose

This library could be useful if you have several cases, when you fill entity from an array data.

For example, you retrieve data from client and create new entity and another way you get this entity from import file.

Instead of create separate services to filling entity from array data set you could just specify entity fields for filling and pass only those properties which you need.

Requirements

Installation

You can install the package via composer:

For Symfony project: Register AnnotationMapper as service in services.yml:

For other just init new mapper object

Usage

At first you need to mark your setters in doctrine entity with DTO annotation

Then just pass input data with object to fillObject method in controller like this (Example for Symfony project, but you can use it with any framework or without it):

That's it! Your entity will updated with new data.

Available simple types: string, float, bool, boolean, int, integer, datetime, array. Trying to use other types without relation will throw the OK\Dto\Exception\MapperInvalidTypeException.

You can use any entity class as type, you just need to specify relation for it: ManyToOne, OneToMany, ManyToMany

Testing

Information

Basic usage

All useful information will be retrieved from Doctrine annotations if property set or type is not set in DTO annotation.

Using only simple types

If you don't use Doctrine\orm you could use this mapper anyway.

Just create mapper without the second parameter and with you own Reader implementation if need.

And then you can use only the simple types.

Case sensitivity

You can use both snake_case and camelCase in name field and mapper will check both of variants in dataset if doesn't find the strict key. For example: If you have annotation:

and dataset:

It's fine. At first mapper check the strict name customerNumber, then (if name doesn't exist) transforms name to customer_number and check it again. It works other way too (from snake_case to camelCase).

Several naming

If you need to have several names for one Dto annotation just list them via | delimiter and then you can use different name in data for different cases:

If in dataset existed more then one from this set of names, then mapper will return first found.

Using ManyToMany relation

For using ManyToMany relation you need to implement OK\Dto\Repository\SearchCollectionInterface for you entity repository or you can just extends from OK\Dto\Repository\EntityRepository

Using OneToMany relation

Here are two ways to use this relation:

The first one when related entity existed then you need to pass array of id to dataset:

Another way when you need to create new Entity, then you need to pass data to create:

You can combine both this way in one dataset:

License

The MIT License (MIT). Please see License File for more information.

All versions of dto-annotation-mapper with dependencies

PHP Build Version
Package Version
Requires php Version >=7.4
doctrine/orm Version ^2
ext-json Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package ok/dto-annotation-mapper contains the following files

Loading the files please wait ....