eclipxe/construct-named-parameters

Helper functions to create objects using an array as named parameters

eclipxe/construct-named-parameters - Helper functions to create objects using an array as named parameters

![Source Code][badge-source] ![Software License][badge-license] [![Scrutinizer][badge-quality]][quality] ![Coverage Status][badge-coverage] , _(*1)

PHP does not have the option to call a method or instance an object using named parameters. This is a library I use in other projects to simplify the task of create objects based on named parameters., _(*2)

See PHP RFC: Named Parameters, _(*3)

Instalation

Use composer to install this library composer require eclipxe/construct-named-parameters, _(*4)

Basic use

<?php

class Foo
{
    public function __construct($a, $b, $c, $d) {}
}

$foo = construct_named_parameters(Foo::class, [
    'd' => 123,
    'b' => 'second',
    'a' => 'a argument',
    'c' => false,
    'xtra' => 'baz',
]);

// this will return the result of:
new Foo('a argument', 'second', false, 123);

Why this library exists?

My motivation start in a project that contains a lot of domain objects that need to be instantiated and commonly I had all the information in one single array. This library result very useful in those cases., _(*5)

It even contains a method that put all parameters and values as lowercase to easily match the constructor requirement. Be aware that in some weird cases a constructor can contain two parameters with the same name but in different case., _(*6)

How it knows the constructor arguments?

The only way I found is using \Reflection., _(*7)

The bad is that reflection can be expensive., _(*8)

The good part is that the function \ConstructNamedParameters\Builder::retrieveArguments has a cache of the name of the class, so, it will only investigate the constructor the first time and the second will use the cached information., _(*9)

The cache can not be cleaned or forced to reload, and there is no need to do it. A constructor of a class cannot change once it exists, right?, _(*10)

About the public functions:

Contributing

Contributions are welcome! Please read CONTRIBUTING for details and don't forget to take a look in the TODO and CHANGELOG files., _(*11)

Copyright and License

The construct-named-parameters library is copyright © Carlos C Soto and licensed for use under the MIT License (MIT). Please see LICENSE for more information., _(*12)