什么是容器
在開發(fā)過程中，經(jīng)常會(huì)用到的一個(gè)概率就是依賴注入。我們借助依懶注入來解耦代碼，選擇性的按需加載服務(wù)，而這些通常都是借助容器來實(shí)現(xiàn)。
容器實(shí)現(xiàn)對(duì)類的統(tǒng)一管理，并且確保對(duì)象實(shí)例的唯一性
常用的容器網(wǎng)上有很多，如PHP-DI 、 YII-DI 等各種實(shí)現(xiàn)，通常他們要么大而全，要么高度適配特定業(yè)務(wù)，與實(shí)際需要存在沖突。
出于需要，我們自己造一個(gè)輕量級(jí)的輪子，為了保持規(guī)范，我們基于PSR-11 來實(shí)現(xiàn)。
PSR-11
PSR 是 php-fig 提供的標(biāo)準(zhǔn)建議，雖然不是官方組織，但是得到廣泛認(rèn)可。PSR-11 提供了容器接口。他包含 ContainerInterface 和 兩個(gè)異常接口，提供使用建議。
/**
* Describes the interface of a container that exposes methods to read its entries.
*/
interface ContainerInterface
{
/**
* Finds an entry of the container by its identifier and returns it.
*
* @param string $id Identifier of the entry to look for.
*
* @throws NotFoundExceptionInterface No entry was found for **this** identifier.
* @throws ContainerExceptionInterface Error while retrieving the entry.
*
* @return mixed Entry.
*/
public function get($id);
/**
* Returns true if the container can return an entry for the given identifier.
* Returns false otherwise.
*
* `has($id)` returning true does not mean that `get($id)` will not throw an exception.
* It does however mean that `get($id)` will not throw a `NotFoundExceptionInterface`.
*
* @param string $id Identifier of the entry to look for.
*
* @return bool
*/
public function has($id);
}
實(shí)現(xiàn)示例
我們先來實(shí)現(xiàn)接口中要求的兩個(gè)方法
abstract class AbstractContainer implements ContainerInterface
{
protected $resolvedEntries = [];
/**
* @var array
*/
protected $definitions = [];
public function __construct($definitions = [])
{
foreach ($definitions as $id => $definition) {
$this->injection($id, $definition);
}
}
public function get($id)
{
if (!$this->has($id)) {
throw new NotFoundException("No entry or class found for {$id}");
}
$instance = $this->make($id);
return $instance;
}
public function has($id)
{
return isset($this->definitions[$id]);
}
實(shí)際我們?nèi)萜髦凶⑷氲膶?duì)象是多種多樣的，所以我們單獨(dú)抽出實(shí)例化方法。
public function make($name)
{
if (!is_string($name)) {
throw new \InvalidArgumentException(sprintf(
'The name parameter must be of type string, %s given',
is_object($name) ? get_class($name) : gettype($name)
));
}
if (isset($this->resolvedEntries[$name])) {
return $this->resolvedEntries[$name];
}
if (!$this->has($name)) {
throw new NotFoundException("No entry or class found for {$name}");
}
$definition = $this->definitions[$name];
$params = [];
if (is_array($definition) isset($definition['class'])) {
$params = $definition;
$definition = $definition['class'];
unset($params['class']);
}
$object = $this->reflector($definition, $params);
return $this->resolvedEntries[$name] = $object;
}
public function reflector($concrete, array $params = [])
{
if ($concrete instanceof \Closure) {
return $concrete($params);
} elseif (is_string($concrete)) {
$reflection = new \ReflectionClass($concrete);
$dependencies = $this->getDependencies($reflection);
foreach ($params as $index => $value) {
$dependencies[$index] = $value;
}
return $reflection->newInstanceArgs($dependencies);
} elseif (is_object($concrete)) {
return $concrete;
}
}
/**
* @param \ReflectionClass $reflection
* @return array
*/
private function getDependencies($reflection)
{
$dependencies = [];
$constructor = $reflection->getConstructor();
if ($constructor !== null) {
$parameters = $constructor->getParameters();
$dependencies = $this->getParametersByDependencies($parameters);
}
return $dependencies;
}
/**
*
* 獲取構(gòu)造類相關(guān)參數(shù)的依賴
* @param array $dependencies
* @return array $parameters
* */
private function getParametersByDependencies(array $dependencies)
{
$parameters = [];
foreach ($dependencies as $param) {
if ($param->getClass()) {
$paramName = $param->getClass()->name;
$paramObject = $this->reflector($paramName);
$parameters[] = $paramObject;
} elseif ($param->isArray()) {
if ($param->isDefaultValueAvailable()) {
$parameters[] = $param->getDefaultValue();
} else {
$parameters[] = [];
}
} elseif ($param->isCallable()) {
if ($param->isDefaultValueAvailable()) {
$parameters[] = $param->getDefaultValue();
} else {
$parameters[] = function ($arg) {
};
}
} else {
if ($param->isDefaultValueAvailable()) {
$parameters[] = $param->getDefaultValue();
} else {
if ($param->allowsNull()) {
$parameters[] = null;
} else {
$parameters[] = false;
}
}
}
}
return $parameters;
}
如你所見，到目前為止我們只實(shí)現(xiàn)了從容器中取出實(shí)例，從哪里去提供實(shí)例定義呢，所以我們還需要提供一個(gè)方水法
/**
* @param string $id
* @param string | array | callable $concrete
* @throws ContainerException
*/
public function injection($id, $concrete)
{
if (is_array($concrete) !isset($concrete['class'])) {
throw new ContainerException('數(shù)組必須包含類定義');
}
$this->definitions[$id] = $concrete;
}
只有這樣嗎？對(duì)的，有了這些操作我們已經(jīng)有一個(gè)完整的容器了，插箱即用。
不過為了使用方便，我們可以再提供一些便捷的方法，比如數(shù)組式訪問。
class Container extends AbstractContainer implements \ArrayAccess
{
public function offsetExists($offset)
{
return $this->has($offset);
}
public function offsetGet($offset)
{
return $this->get($offset);
}
public function offsetSet($offset, $value)
{
return $this->injection($offset, $value);
}
public function offsetUnset($offset)
{
unset($this->resolvedEntries[$offset]);
unset($this->definitions[$offset]);
}
}
這樣我們就擁有了一個(gè)功能豐富，使用方便的輕量級(jí)容器了，趕快整合到你的項(xiàng)目中去吧。
點(diǎn)擊這里查看完整代碼
以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
您可能感興趣的文章:- PHP 應(yīng)用容器化以及部署方法
- 深入理解 PHP7 中全新的 zval 容器和引用計(jì)數(shù)機(jī)制
- PHP解耦的三重境界（淺談服務(wù)容器）
- PHP進(jìn)階學(xué)習(xí)之依賴注入與Ioc容器詳解
- php 接口類與抽象類的實(shí)際作用
- php接口和抽象類使用示例詳解
- PHP調(diào)用wsdl文件類型的接口代碼分享
- PHP生成json和xml類型接口數(shù)據(jù)格式
- PHP中抽象類、接口的區(qū)別與選擇分析
- PHP容器類的兩種實(shí)現(xiàn)方式示例
