Categories: Мадженто 2

Краткий обзор генерации кода в Magento 2

С появлением Magento 2 многие вопросы требуют объяснения. Сегодня очередь дошла до разбора процесса генерации кода в системе, как одной из новых ключевых концепций в Magento 2. Вас когда-либо волновал вопрос, когда и почему создается код в папке var/generation и какой процесс за это отвечает? Если это так, тогда эта статья для вас.

 

 

Генерация кода – краткий обзор

Генерация кода может быть вызвана двумя способами:

  • На лету. Вы объявляете класс с понятным именем, которое следует определенному паттерну. Когда система пытается автозагрузить класс и не находит его, этот класс будет сгенерирован. Это очень полезно в режиме разработки, так как система делает все сама, вам не нужно запускать в консоли команду генерации снова и снова. Однако это замедляет работу системы.
  • Командная строка. Когда вы запускаете генерацию кода из командной строки, система проверит код и сгенерирует все необходимые классы. Данный способ полезен для сайта он-лайн, поскольку он не нагружает систему.

 

Для второго способа вам нужно запускать команду:

magento setup:di:compile

 

чтобы создать необходимые файлы. Оба варианта ведут к созданию классов в папке var/generation.

 

 

Какие классы генерируются?

Существует несколько типов классов, которые генерируются системой. Мы остановимся на 3-х самых важных:

  • Фабричные
  • Прокси
  • Плагины

 

А теперь давайте по порядку.

 

Фабричные

Фабричные классы используются для создания объектов, которые не могут быть вставлены автоматически. Например, объект товара должен быть загружен из базы данных, но для контейнера инъекции зависимостей недостаточно информации для создания этого объекта. Вот почему используются фабрики.

 

Давайте посмотрим на существующий класс в app/code/Magento/Catalog/Model/Product/Copier.php

 

/**
* @param CopyConstructorInterface $copyConstructor
* @param \Magento\Catalog\Model\ProductFactory $productFactory
*/public function __construct(
  CopyConstructorInterface $copyConstructor,
  \Magento\Catalog\Model\ProductFactory $productFactory
) {
  $this->productFactory = $productFactory;
  $this->copyConstructor = $copyConstructor;
}

 

Пояснение рабочего процесса:

  • Разработчик объявляет зависимость от фабрики в конструкторе ($productFactory)
  • Менеджер объектов вводит эту зависимость
  • Разработчик может получить доступ к методу create() (единственному методу на фабричном объекте) для создания как можно большего количества экземпляров Product.

 

 

Вот как вы, как разработчик, можете использовать фабрики. В фоновом режиме система сгенерирует файл, расположенный в /var/generation/Magento/Catalog/Model/ProductFactory.php, который выглядит так (упрощенно):

<?php
namespace Magento\Catalog\Model;

class ProductFactory
{
 public function __construct(
  \Magento\Framework\ObjectManagerInterface $objectManager, $instanceName = '\\Magento\\Catalog\\Model\\Product'
 )
 {
  $this->_objectManager = $objectManager;
  $this->_instanceName = $instanceName;
 }

 public function create(array $data = array())
 {
  return $this->_objectManager->create($this->_instanceName, $data);
 }
}

 

Как мы видим, единственной целью фабричных классов является делегирование инстанциирования объектов объектным менеджерам.

 

 

Прокси

Magento 2 использует конструктор инъекций, в котором указываются все требуемые зависимости. Вы не можете создавать объекты без объявления всех зависимостей. Что делать, если вы хотите иметь дополнительные зависимости? Для этого существуют прокси.

 

<config>
 <type name="Magento\Catalog\Model\Resource\Product\Collection">
  <arguments>
   <argument name="customerSession" xsi:type="object">
     Magento\Customer\Model\Session\Proxy
   </argument>
  </arguments>
 </type>
</config>

 

 

Пояснение рабочего процесса:

  • Разработчик никогда не трогает PHP файлы для использования прокси, он использует только файл di.xml
  • Обратите внимание на ключевое слово Proxy, добавленное в Magento\Customer\Model\Session\. Зависимости, отмеченные таким образом, являются необязательными зависимостями.

 

 

В фоновом режиме система сгенерирует файл, расположенный в /var/generation/Magento/Customer/Model/Session/Proxy.php, который выглядит так (упрощенно):

 

<?php
namespace Magento\Customer\Model\Session;

class Proxy extends \Magento\Customer\Model\Session
{
 protected function _getSubject()
 {
  if (!$this->_subject) {
   $this->_subject = true === $this->_isShared
   ? $this->_objectManager->get($this->_instanceName)
   : $this->_objectManager->create($this->_instanceName);
  }
  return $this->_subject;
 }
 ...
}

 

 

Как мы видим, это расширяет исходный класс и переопределяет каждый метод, который делегирует вызов к исходному образцу. Это означает, что при первом вызове прокси метода исходный экземпляр создается со всеми его зависимостями. Поэтому единственной целью прокси является отсрочка создания экземпляра (и его зависимостей) до самого первого использования.

 

 

Плагины (перехватчики)

Проще говоря, плагины являются основными механизмами кастомизации Magento 2. Больше не нужно перезаписывать класс. Плагин позволяет вам подключаться и делать что-то до, после или вокруг любого public метода приложения.

Давайте посмотрим на системный плагин:

 

<?php
namespace Magento\Store\App\Action\Plugin;

class StoreCheck
{
 public function aroundDispatch(
  \Magento\Framework\App\Action\Action $subject,
  \Closure $proceed,
  \Magento\Framework\App\RequestInterface $request
 ) {
  if (!$this->_storeManager->getStore()->getIsActive()) {
   throw new \Magento\Framework\Exception\State\InitException(
   __('Current store is not active.')
  );
  }
  return $proceed($request);
 }
}

 

 

Пояснение рабочего процесса:

  • Разработчик пишет класс плагина в зависимости от требований (ознакомьтесь с официальной документацией)
  • Разработчик регистрирует плагин в файле di.xml, например, так:

 

<config>
 <type name="Magento\Framework\App\Action\Action">
  <plugin name="storeCheck"
   type="Magento\Store\App\Action\Plugin\StoreCheck"
   sortOrder="10"/>
 </type>
</config>

 

 

В результате система сгенерирует класс Interceptor в /var/generation/Magento/Framework/App/Action/Interceptor.php

 

<?php
namespace Magento\Framework\App\Action\Action;

class Interceptor extends \Magento\Framework\App\Action\Action
{
 public function dispatch(\Magento\Framework\App\RequestInterface $request)
 {
  $pluginInfo = $this->pluginList->getNext('\\Magento\\Framework\\App\\Action\\Action', 'dispatch');
  if(!$pluginInfo) {
   return parent::dispatch($request);
  } else {
   return $this->__callPlugins('dispatch', func_get_args(), $pluginInfo);
  }
 }
}

 

 

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

 

 

Вот и все на сегодня. Пишите свои комментарии в форме комментирования ниже.

 

Tags: Magento2

Recent Posts

Мать Тереза

Если молитва – это твое обращение к Богу, то интуиция – это разговор Бога с… Read More

17/02/2021

Особенности маркировки косметики

Косметическая продукция – товары, принадлежащие к особой категории. Упаковка должна соответствовать ряду требований. Важно, чтобы… Read More

16/02/2021

Основные компоненты системы раздвижных дверей (купе)

Раздвижные двери купе – это стильный и современный способ добавить индивидуальности вашему дому. Они не… Read More

12/02/2021

Удивительные места Украины для отдыха душой и телом

Украину можно смело назвать не только одной из самых старейших стран в Европе, но и… Read More

05/02/2021

Улучшаем показатели Core Web Vitals – основной тренд SEO в 2021 году

Ранее мы писали о том, что такое Основные интернет-показатели (по-английски Core Web Vitals) в инструменте… Read More

30/01/2021

Ответы на самые распространенные вопросы о жестких дисках для ноутбуков

Не все жесткие диски одинаковы, и когда вы покупаете новый ноутбук, на выбор у вас… Read More

29/01/2021