avz-cmf / zaboy-dic
DI - InsideConstruct
Requires
- php: ^5.6 || ^7.0
- avz-cmf/zaboy-installer: ^2.1
- psr/http-message: ^1.0
- zendframework/zend-config: ^2.6
- zendframework/zend-diactoros: ^1.1
- zendframework/zend-servicemanager: ^3.0
- zendframework/zend-stdlib: ^3
- zendframework/zend-stratigility: ^1.1
Requires (Dev)
- phpunit/phpunit: ^4.0
This package is not auto-updated.
Last update: 2024-11-09 20:39:42 UTC
README
Оглавление
Документация
##Быстрый старт
###Обычная практика
Пусть у нас есть класс, принимающий 3 сервиса в качестве зависимостей:
class Class1
{
public $propA;
public $propB;
public $propC;
public function __construct($propA = null, $propB = null, $propC = null)
{
$this->propA = $propA;
$this->propB = $propB;
$this->propC = $propC;
}
}
/* @var $contaner ContainerInterface */
global $contaner;
$propA = $contaner->has('propA') ? $contaner->get('propA') : null;
$propB = $contaner->has('propB') ? $contaner->get('propB') : null;
$propC = $contaner->has('propC') ? $contaner->get('propC') : null;
new Class1($propA, $propB, $propC);
Мы получили из контейнера зависимости и присвоили их одноименным свойствам объекта.
###Теперь то-же самое с использованием InsideConstruct::initServices()
:
Если имя параметра соответствует имени сервиса и имени свойства объекта:
class Class1
{
public $propA;
public $propB;
public $propC;
public function __construct($propA = null, $propB = null, $propC = null)
{
InsideConstruct::initServices();
}
}
new Class1();
Все три сервиса будут инициализированы сервисами из $containr
как в примере выше.
Вызов InsideConstruct::initServices()
не изменяет переданные в констрактор параметры.
Если у параметров констрактора указаны тип или интерфейс, то сервисы, полученные вызовом
InsideConstruct::initServices()
будут проверены на соответствие.
Инициализируются Public
, Protected
, и Private
свойства объекта. Не инициализируются Static
свойства и Private
свойства предков.
##Использование
Что возвращает метод InsideConstruct::initServices();
Возвращается массив ['param1Name'=>value1', 'param2Name' => 'value2', ...]
Как перекрыть умолчания
Если так:
new Class1(new stdClass(), null);
то только один (последний) параметр будет инициализирован сервисом $contaner->get('propC')
.
Два других получат значения new stdClass(
) и null
. Но присваивания свойствам объекта или вызовы сеттеров (см. далее) отработают для всех параметров.
Сеттеры ($this->setPropA($value)
)
Если для параметра констрактора определен соответствующий (по имени) сеттер - он будет вызван. Сеттеры имеют приоритет над свойствами. Если для параметра есть и сеттер и свойство, то будет вызван сеттер, а присваивание свойству не будет произведено.
А если наследование?
Предположим у нас есть базовый класс:
class Class0
{
public $propA;
public function __construct($propA = null)
{
InsideConstruct::initServices();
}
}
$class0 = new Class0; // $class0->propA = $container->get('propA');
, а нам нужно изменить используемый сервис: // $class0->propA = $container->get('newPropA');
Можно так:
class Class1 extends Class0
{
public function __construct($newPropA = null)
{
$params = InsideConstruct::initServices(['newPropA']);
$propA = $params['newPropA'];
parent::__construct(propA);
}
};
Параметры вызова
В прошлом примере InsideConstruct::initServices(['newPropA']);
добавлен параметр вызова 'newPropA'.
Зачем это нужно? Дело в том, что у объекта Class1
нет ни свойства $this->newPropA
,
ни метода $this->setNewPropA()
. И он не будет пытаться загрузить сервис 'newPropA' в случае , если параметр не передан в констрактор.
Передача параметра InsideConstruct::initServices(['newPropA']);
явно указывает на initServices()
загрузить сервис 'newPropA'
.
Еще раз коротко о главном
Если есть соответствующий сеттер или свойство - значение будет присвоено.
Если параметр передан (даже если NULL
) - сервис из контейнера загружен не будет.
Если параметр не передан, сервис из контейнера буде загружен если есть сеттер, свойство или имя параметра указанно в аргументе вызова функции InsideConstruct::initServices([...);