lukaszmakuch/class-based-registry

Registry that allows to associate a value to one ore more classes and then fetch this value by passing objects that implements these classes

ClassBasedRegistry

Allows to associate a value to one or more classes and then fetch this value by passing objects that implement these classes., _(*1)

Usage

Environment

Let's assume that we have classes like these:, _(*2)

class Animal {}
class Elephant extends Animal {}
class Plant {}

To get a new instance of the registry create it:, _(*3)

$r = new \lukaszmakuch\ClassBasedRegistry\ClassBasedRegistry();

Simple example

Associate 42 with the Animal class:, _(*4)

$r->associateValueWithClasses(
    42,
    [Animal::class]
);

Fetch it by providing any animal..., _(*5)

$r->fetchValueByObjects([new Animal()]); //42

... that may be an elephant!, _(*6)

$r->fetchValueByObjects([new Elephant()]); //42

Multiple classes

It is possible to associate value with many classes:, _(*7)

$r->associateValueWithClasses(
    1970,
    [Animal::class, Plant::class]
);

While fetching objects may be passed in any order:, _(*8)

$r->fetchValueByObjects([new Plant(), new Elephant()]); //1970

Throwing exceptions

When it's not possible to obtain any value, then a \lukaszmakuch\ClassBasedRegistry\Exception\ValueNotFound exception is thrown:, _(*9)

try {
    $r->fetchValueByObjects([new Plant()]);
} catch (\lukaszmakuch\ClassBasedRegistry\Exception\ValueNotFound $e) {
  //it was not possible to fetch any value by a plant
}

Installation

Use composer to get the latest version:, _(*10)

$ composer require lukaszmakuch/class-based-registry