eclipxe / construct-named-parameters
Helper functions to create objects using an array as named parameters
Requires
- php: >=5.6
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.3
- jakub-onderka/php-parallel-lint: ^0.9.2
- phpunit/phpunit: ^5.7
- squizlabs/php_codesniffer: ^3.0
This package is auto-updated.
Last update: 2024-11-09 18:38:21 UTC
README
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.
Instalation
Use composer to install this library composer require eclipxe/construct-named-parameters
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.
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.
How it knows the constructor arguments?
The only way I found is using \Reflection
.
The bad is that reflection can be expensive.
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.
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?
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.
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.