/property-loader

PHP library to dynamically load object properties

Primary LanguagePHPMIT LicenseMIT

Dynamic Property Loader Library

Build Status Coverage Status

A PHP library to dynamically load object properties using custom handlers (useful for DTO's). It comes with two ClassMetadata mapping loaders.

  • StaticMethodLoader: Load mapping configuration using configurePropertyLoaderMetadata() method.
  • AnnotationLoader: Load mapping configuration using annotations existed on src/Loaders/ directory

Installation

The recommended way to install property-loader is using Composer.

# Install Composer
$ curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version of ibanfirst-sdk.

$ composer require guennichi/property-loader

After installing, you need to require Composer's autoloader:

require 'vendor/autoload.php';

Usage

The entry point of this library is the Guennichi\PropertyLoader class.

$mappingLoader = new Guennichi\PropertyLoader\Mapping\Loader\AnnotationLoader(
    new Doctrine\Common\Annotations\AnnotationReader()
);

$propertyLoader = new Guennichi\PropertyLoader\PropertyLoader($mappingLoader);

Create a Custom Property Loader

Create the Loader

You can create a custom loader by extending the base abstract loader class, Guennichi\PropertyLoader\Loader. By doing so, you'll be able to manage even how your custom loader will load the property inside a given object.

As an example you're going to create a basic property loader that dynamically generates an email address inside a property for a person object.

/**
 * @Annotation
 * @Target("PROPERTY")
 */
class Email extends Guennichi\PropertyLoader\Loader {
    // The source property name
    // Which we will use to generate the email
    // based on it's value.
    public string $source;
}
Create the Loader Handler

As you can see, a loader class is fairly minimal. The actual handler is performed by another “constraint validator” class. The constraint validator class is specified by the constraint’s handledBy() method, which has this default logic:

// in the base Guennichi\PropertyLoader\Loader class
public function handledBy(): string
{
    return static::class.'Handler';
}

In other words, if you create a custom Loader (e.g. Email), PropertyLoader library will automatically look for another class, EmailHandler when actually performing the loading.

The handler class only has one required method handle(), check guennichi/property-loader-bundle package for more details about handlers.

Using the new Loader
namespace App\DTO;

use App\Loaders as AcmeLoad;

class Person
{
    // ...

    public string $name;
    
    /**
     * @AcmeLoad\Email(source="name") 
     */
    public string $email;
    // ...
}

As you can see here, we added the new custom loader inside the Person class, in our case, we want to load the property "email" based on the value of the "name" property.

Now, it's time to see how things are going for our Person object:

$person = new Person();
$person->name = 'radhi';

// Load properties based on mappings and stored handlers
$propertyLoader->load($person, function (Email $emailLoader, ExecutionContextInterface $context {
        // Get the sourceProperty reflection object
        // based on "source" (name of property)
        $sourceProperty = $context->getClassMetadata()
        ->getReflectionClass()
        ->getProperty($emailLoader->source);
        
        $object = $context->getObject();

        $value = $sourceProperty->getValue($object) . '@guennichi.com';

        $context->getPropertyMetadata()->setPropertyValue($value, $object);
});


echo $person->email; // radhi@guennichi.com

Supporting PHP >= 7.4

This client library only supports PHP version >= 7.4 , Check Supported Versions for more information.

Questions?

If you have any questions please open an issue.

License

This library is released under the MIT License. See the bundled LICENSE file for details.