1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
<?php
/**
* Interface Injector.
*
* @package AmpProject\AmpWP
*/
namespace AmpProject\AmpWP\Infrastructure;
/**
* The dependency injector should be the only piece of code doing actual
* instantiations, with the following exceptions:
* - Factories can instantiate directly.
* - Value objects should be instantiated directly where they are being used.
*
* Through technical features like "binding" interfaces to classes or
* "auto-wiring" to resolve all dependency of a class to be instantiated
* automatically, the dependency injector allows for the largest part of the
* code to adhere to the "Code against Interfaces, not Implementations"
* principle.
*
* Finally, the dependency injector should be the only one to decide what
* objects to "share" (always handing out the same instance) or not to share
* (always returning a fresh new instance on each subsequent call). This
* effectively gets rid of the dreaded Singletons.
*
* @since 2.0
* @internal
*/
interface Injector extends Service {
/**
* Make an object instance out of an interface or class.
*
* @param string $interface_or_class Interface or class to make an object
* instance out of.
* @param array $arguments Optional. Additional arguments to pass
* to the constructor. Defaults to an
* empty array.
* @return object Instantiated object.
*/
public function make( $interface_or_class, $arguments = [] );
/**
* Bind a given interface or class to an implementation.
*
* Note: The implementation can be an interface as well, as long as it can
* be resolved to an instantiatable class at runtime.
*
* @param string $from Interface or class to bind an implementation to.
* @param string $to Interface or class that provides the implementation.
* @return Injector
*/
public function bind( $from, $to );
/**
* Bind an argument for a class to a specific value.
*
* @param string $interface_or_class Interface or class to bind an argument
* for.
* @param string $argument_name Argument name to bind a value to.
* @param mixed $value Value to bind the argument to.
*
* @return Injector
*/
public function bind_argument(
$interface_or_class,
$argument_name,
$value
);
/**
* Always reuse and share the same instance for the provided interface or
* class.
*
* @param string $interface_or_class Interface or class to reuse.
* @return Injector
*/
public function share( $interface_or_class );
/**
* Delegate instantiation of an interface or class to a callable.
*
* @param string $interface_or_class Interface or class to delegate the
* instantiation of.
* @param callable $callable Callable to use for instantiation.
* @return Injector
*/
public function delegate( $interface_or_class, callable $callable );
}
|