digiaonline / instance-factory
A factory for constructing objects from arrays of properties
Installs: 47 315
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 5
Forks: 0
Open Issues: 0
Requires
- php: >=7.1
Requires (Dev)
- phpunit/phpunit: ^7.3
This package is auto-updated.
Last update: 2023-03-12 21:24:00 UTC
README
A factory for constructing objects from arrays of properties
Installation
composer require digiaonline/instance-factory
Usage
<?php require_once(__DIR__ . '/vendor/autoload.php'); /** * A class we want to be able to instantiate. Phpdoc has been left out for brevity. */ class Person { private $name; private $age; private $optionalInformation; public function __construct(string $name, int $age, ?string $optionalInformation = null) { $this->name = $name; $this->age = $age; $this->optionalInformation = $optionalInformation; } public function getName(): string { return $this->name; } public function getAge(): int { return $this->age; } public function getOptionalInformation(): ?string { return $this->optionalInformation; } } // Create one instance where we skip the optional information /** @var Person $personOne */ $personOne = \Digia\InstanceFactory\InstanceFactory::fromProperties(Person::class, [ 'name' => 'John Smith', 'age' => 34, ]); // Create another instance where we do supply optional information /** @var Person $personOne */ $personTwo = \Digia\InstanceFactory\InstanceFactory::fromProperties(Person::class, [ 'name' => 'Alice Smith', 'age' => 33, 'optionalInformation' => 'Not related to John Smith', ]);
This will print the following:
class Person#5 (3) {
private $name =>
string(10) "John Smith"
private $age =>
int(34)
private $optionalInformation =>
NULL
}
class Person#2 (3) {
private $name =>
string(11) "Alice Smith"
private $age =>
int(33)
private $optionalInformation =>
string(25) "Not related to John Smith"
}
If instantiation fails for whatever reason, \RuntimeException
is thrown.
License
MIT