Download the PHP package rollun-com/rollun-dic without Composer

On this page you can find all versions of the php package rollun-com/rollun-dic. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package rollun-dic

rollun-dic


Оглавление


Справка

Иньекция зависимости

Через сеттер метод - если существует сеттер для свойста, при иньекции будет использован он. через свойство/атрибут обьекта - зависимость будет иньецирована через свойство, в случае если соответсвующий сеттер не был найден.

public свойства - инициализация свойств в инстансе с учетом иерархии наследования protected свойства -инициализация свойств в инстансе с учетом иерархии наследования private свойства - инициализация свойств в инстансе без иерархии наследования

Загрузка зависимостей и типизация параметров

Если параметр типизирован простым типом то такой параметр не будет получаться из контейнера.

простые типы (int,string,float,array,resource,)

Если параметр типизирован именем класса или интерфейса, то такой сервис будет загружен из контейнера и в случае неудачи будет выброшено исключение.

В случае если параметр был не типизирован, то сервис попытается загрузится из контейнера, а в случае неудачи будет использовано значение по умолчанию.

Методы и специфика вызовов

init

Инициализирует сервис зависимостями указаными в методе __construct.
Вызывает родительский конструктор в случае наличия такового и иньецирует зависимости в него. Так же, позволяет пробросить зависимость в родительский конструктор.
Для этого нужено в параметры метода передать массив где укзать мапинг.
В качестве ключа массива указываем имя параметра(сервиса) в конструкторе, а в качестве значения - имя параметра конструктора родительского класса.

setConstructParams

Инициализирует сервис зависимостями указаными в методе __construct.

Родительский конструктор не вызывается

В качестве параметров можно передать конфиг маппинга.
В качестве ключа - имя параметра конструктора, а в качестве значения имя сервиса которое нужно загрузить.

initWakeup

Позволяет инициализировать сервис зависимостями.
В качетсве параметра можно передать конфиг мапина.
В качестве ключа - имя свойства/атрибут класа, а в качестве значения имя сервиса которое нужно загрузить.

runParentConstruct

Вызывает родительский конструктор
В качетсве параметра можно передать конфиг мапина.
В качестве ключа - имя параметра конструктора(родительского класса), а в качестве значения имя сервиса которое нужно загрузить.

Каркас для создания приложений.

DI - InsideConstruct

Быстрый старт

Обычная практика

Пусть у нас есть класс, принимающий 3 сервиса в качестве зависимостей:

Мы получили из контейнера зависимости и присвоили их одноименным свойствам объекта.

Теперь то-же самое с использованием InsideConstruct::init():

Если имя параметра соответствует имени сервиса и имени свойства объекта:

Все три сервиса будут инициализированы сервисами из $containr как в примере выше.
Вызов InsideConstruct::init не изменяет переданные в констрактор параметры.
Если у параметров констрактора указаны тип или интерфейс, то сервисы, полученные вызовом InsideConstruct::init() будут проверены на соответствие.
Инициализируются Public, Protected, и Private свойства объекта, а так же свойства родителя, если они не были инициализированы ранее. После будет вызван конструктор родителя и туда будет переданы сервисы.

Не инициализируются Static свойства и Private свойства предков.

Использование

Что возвращает метод InsideConstruct::init();

Возвращается массив ['param1Name'=>value1', 'param2Name' => 'value2', ...]

Как перекрыть умолчания

Если так:

        new Class1(new stdClass(), null);

то только один (последний) параметр будет инициализирован сервисом $container->get('propC').
Два других получат значения new stdClass() и null. Но присваивания свойствам объекта или вызовы сеттеров (см. далее) отработают для всех параметров.

Сеттеры ($this->setPropA($value))

Если для параметра констрактора определен соответствующий (по имени) сеттер - он будет вызван. Сеттеры имеют приоритет над свойствами. Если для параметра есть и сеттер и свойство, то будет вызван сеттер, а присваивание свойству не будет произведено.

А если наследование?

Предположим у нас есть базовый класс:

, а нам нужно изменить используемый сервис:

Можно так:

Или же используя метод init() мы можем инициализировать наши зависимости и зависимости родительского класа. Если в конструкторе нашего класcа имеется имя того же сервиса что и в конструкторе родительского класса то зависимость пробрасывается - будет передана в конструктор родителя в качестве параметра. Так же метод init() пренимает массив подстановки параметров, в случае если наследник переопределяет зависимость родителя. В такком случае можно передать массив в котором ключ будет содержать имя переопределенной зависимости, а значение имя изначальной зависимости.

А если нужно в промежутке что то сделать ?

, а нам нужно изменить используемый сервис:

Можно так:

Мы моежем использовать метод runParentConstruct() для того что бы инициализировать родительские зависимости через конструктор, Так же мы можем передавать в них массив содержащий те поля которые мы явно хотим передать в конструктор родительского класcа.

А вызвав метод setConstructParams() мы инициализируем свои зависимости. Так же можно передать массив в качесвте парамтера где ключами указать имена переменных класса для который есть сетеры и которые хотите ини циализтировать, а в качестве значения передать имя сервиса.

Параметры вызова

В прошлом примере InsideConstruct::runParentConstruct(['propA' => $propA]); добавлен параметр вызова ['propA' => $propA]. Это сделано для того что бы мы могли передать в конструктор родителя, заранее определенные параметры.

Еще раз коротко о главном

Если есть соответствующий сеттер или свойство - значение будет присвоено.
Если параметр передан (даже если NULL) - сервис из контейнера загружен не будет.
Если параметр не передан, сервис из контейнера буде загружен если есть сеттер или свойство.


All versions of rollun-dic with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
psr/container Version ^1.0 || ^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package rollun-com/rollun-dic contains the following files

Loading the files please wait ....