php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-24 10:39:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

Перевод завершён

Browse Source
This commit is contained in:
quot;brussens
2014-09-29 21:14:01 +03:00
parent 4f12921b77
commit fd6c2b2146
1 changed files with 28 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

62
docs/guide-ru/concept-di-container.md
View File

@@ -238,35 +238,33 @@ $lister = new UserLister($finder);
Практическое использование <a name="practical-usage"></a> Практическое использование <a name="practical-usage"></a>
--------------- ---------------
Yii creates a DI container when you include the `Yii.php` file in the [entry script](structure-entry-scripts.md) Yii создаёт контейнер внедрения зависимостей(DI) когда вы подключаете файл `Yii.php` во [входном скрипте](structure-entry-scripts.md)
of your application. The DI container is accessible via [[Yii::$container]]. When you call [[Yii::createObject()]], вашего приложения. Контейнер внедрения зависимостей(DI) доступен через [[Yii::$container]]. При вызове [[Yii::createObject()]],
the method will actually call the container's [[yii\di\Container::get()|get()]] method to create a new object. метод на самом деле вызовет метод контейнера [[yii\di\Container::get()|get()]], что бы создать новый объект.
As aforementioned, the DI container will automatically resolve the dependencies (if any) and inject them Как упомянуто выше, контейнер внедрения зависимостей(DI) автоматически разрешит зависимости (если таковые имеются) и внедрит их в только что созданный объект.
into the newly created object. Because Yii uses [[Yii::createObject()]] in most of its core code to create Поскольку Yii использует [[Yii::createObject()]] в большей части кода своего ядра для создания новых объектов, это означает,
new objects, this means you can customize the objects globally by dealing with [[Yii::$container]]. что вы можете настроить глобальные объекты, имея дело с [[Yii::$container]].
For example, you can customize globally the default number of pagination buttons of [[yii\widgets\LinkPager]]: Например, вы можете настроить по умолчанию глобальное количество кнопок в пейджере [[yii\widgets\LinkPager]]:
```php ```php
\Yii::$container->set('yii\widgets\LinkPager', ['maxButtonCount' => 5]); \Yii::$container->set('yii\widgets\LinkPager', ['maxButtonCount' => 5]);
``` ```
Now if you use the widget in a view with the following code, the `maxButtonCount` property will be initialized Теперь, если вы вызовете в представлении виджет, используя следующий код, то свойство `maxButtonCount` будет инициальзировано, как 5, вместо значения по умолчанию 10, как это определено в классе.
as 5 instead of the default value 10 as defined in the class.
```php ```php
echo \yii\widgets\LinkPager::widget(); echo \yii\widgets\LinkPager::widget();
``` ```
You can still override the value set via DI container, though: Хотя, вы всё ещё можете переопределить установленное значение через контейнер внедрения зависимостей(DI):
```php ```php
echo \yii\widgets\LinkPager::widget(['maxButtonCount' => 20]); echo \yii\widgets\LinkPager::widget(['maxButtonCount' => 20]);
``` ```
Другим примером является использование автоматического внедрения зависимости через конструктор контейнера внедрения зависимостей(DI).
Another example is to take advantage of the automatic constructor injection of the DI container. Предположим, ваш класс контроллера зависит от ряда других объектов, таких как сервис бронирования гостиницы. Вы
Assume your controller class depends on some other objects, such as a hotel booking service. You можете объявить зависимость через параметр конструктора и позволить контейнеру внедрения зависимостей(DI), разрешить её за вас.
can declare the dependency through a constructor parameter and let the DI container to resolve it for you.
```php ```php
namespace app\controllers; namespace app\controllers;
@@ -286,38 +284,34 @@ class HotelController extends Controller
} }
``` ```
If you access this controller from browser, you will see an error complaining the `BookingInterface` Если у вас есть доступ к этому контроллеру из браузера, вы увидите сообщение об ошибке, который жалуется на то, что `BookingInterface`
cannot be instantiated. This is because you need to tell the DI container how to deal with this dependency: не может быть создан. Это потому что вы должны указать контейнеру внедрения зависимостей(DI), как обращаться с этой зависимостью:
```php ```php
\Yii::$container->set('app\components\BookingInterface', 'app\components\BookingService'); \Yii::$container->set('app\components\BookingInterface', 'app\components\BookingService');
``` ```
Now if you access the controller again, an instance of `app\components\BookingService` will be Теперь, если вы попытаетесь получить доступ к контроллеру снова, то экземпляр `app\components\BookingService` будет создан и введён в качестве 3-го параметра конструктора контроллера.
created and injected as the 3rd parameter to the controller's constructor.
When to Register Dependencies <a name="when-to-register-dependencies"></a> Когда следует регистрировать зависимости <a name="when-to-register-dependencies"></a>
----------------------------- -----------------------------
Because dependencies are needed when new objects are being created, their registration should be done Поскольку зависимости необходимы тогда, когда создаются новые объекты, то их регистрация должна быть сделана
as early as possible. The followings are the recommended practices: как можно раньше. Ниже приведены рекомендуемые практики:
* If you are the developer of an application, you can register dependencies in your * Если вы разработчик приложения, то вы можете зарегистрировать зависимости во [входном скрипте](structure-entry-scripts.md) вашего приложения или в скрипте, подключённого во входном скрипте.
application's [entry script](structure-entry-scripts.md) or in a script that is included by the entry script. * Если вы разработчик распространяемого [расширения](structure-extensions.md), то вы можете зарегистрировать зависимости в загрузочном классе расширения.
* If you are the developer of a redistributable [extension](structure-extensions.md), you can register dependencies
in the bootstrap class of the extension.
Summary <a name="summary"></a> Итог <a name="summary"></a>
------- -------
Как dependency injection, так и [service locator](concept-service-locator.md) являются популярными паттернами проектирования, которые позволяют
создавать программное обеспечение в слабосвязаной и более тестируемой манере.
Мы настоятельно рекомендуем к прочтению
[Статью Мартина Фаулера](http://martinfowler.com/articles/injection.html), для более глубокого понимания dependency injection и service locator.
Both dependency injection and [service locator](concept-service-locator.md) are popular design patterns Yii реализует свой [service locator](concept-service-locator.md) поверх контейнера внедрения зависимостей(DI).
that allow building software in a loosely-coupled and more testable fashion. We highly recommend you to read Когда service locator пытается создать новый экземпляр объекта, он перенаправляет вызов на Контейнер внедрения зависимостей (DI).
[Martin's article](http://martinfowler.com/articles/injection.html) to get a deeper understanding of Последний будет разрешать зависимости автоматически, как описано выше.
dependency injection and service locator.
Yii implements its [service locator](concept-service-locator.md) on top of the dependency injection (DI) container.
When a service locator is trying to create a new object instance, it will forward the call to the DI container.
The latter will resolve the dependencies automatically as described above.