12.15.1. Injeção de dependências no controller

No artigo anterior vimos o que é Dependency Injection:

12.15. Services и Dependency Injection.

В этой статье приведен пример кода с Dependency Injection в контроллере.

/modules/custom/drupalbook/src/Controller/ModalFormContactController.php:

<?php

namespace Drupal\drupalbook\Controller;

use Symfony\Component\DependencyInjection\ContainerInterface;
use Drupal\Core\Ajax\AjaxResponse;
use Drupal\Core\Ajax\OpenModalDialogCommand;
use Drupal\Core\Controller\ControllerBase;
use Drupal\Core\Form\FormBuilder;

/**
 * ModalFormContactController class.
 */
class ModalFormContactController extends ControllerBase {

  /**
   * The form builder.
   *
   * @var \Drupal\Core\Form\FormBuilder
   */
  protected $formBuilder;

  /**
   * ModalFormContactController constructor.
   *
   * @param \Drupal\Core\Form\FormBuilder $form_builder
   *   The form builder.
   */
  public function __construct(FormBuilder $form_builder) {
    $this->formBuilder = $form_builder;
  }

  /**
   * {@inheritdoc}
   *
   * @param \Symfony\Component\DependencyInjection\ContainerInterface $container
   *   The Drupal service container.
   *
   * @return static
   */
  public static function create(ContainerInterface $container) {
    return new static(
      $container->get('form_builder')
    );
  }

  /**
   * Callback for modal form.
   */
  public function openModalForm() {
    $response = new AjaxResponse();
    $modal_form = $this->formBuilder->getForm('Drupal\drupalbook\Form\ModalForm');
    $enquiry_title = $this->t("Send an enquiry to @business_name", ['@business_name' => $modal_form['business_name']['#value']]);
    $response->addCommand(new OpenModalDialogCommand($enquiry_title, $modal_form));

    return $response;
  }

}

Давайте разберем части кода для DI (Dependency Injection). 

namespace Drupal\drupalbook\Controller;

Сначала мы указываем namespace (пространство имен), место в котором этот файл лежит, где drupalbook это машинное имя вашего модуля.

use Symfony\Component\DependencyInjection\ContainerInterface;

Подключаем класс ContainerInterface, позже мы будем использовать для получения объектов из Service Container.

  /**
   * The form builder.
   *
   * @var \Drupal\Core\Form\FormBuilder
   */
  protected $formBuilder;

Declaramos a propriedade na qual armazenaremos o objeto vindo do Service Container. O comentário @var \Namespace ajuda sua IDE a entender quais métodos do objeto mostrar no autocomplete.

  /**
   * ModalFormContactController constructor.
   *
   * @param \Drupal\Core\Form\FormBuilder $form_builder
   *   The form builder.
   */
  public function __construct(FormBuilder $form_builder) {
    $this->formBuilder = $form_builder;
  }

Em seguida, no construtor precisamos receber como parâmetro o objeto do Service container; criaremos esse objeto no próximo método create(), e aqui recebemos o objeto e salvamos na propriedade $formBuilder declarada acima. Se você conecta um novo serviço, precisa adicioná-lo parâmetro por parâmetro ao __construct(). Então se você pretende conectar 10 serviços, terá 10 parâmetros.

  /**
   * {@inheritdoc}
   *
   * @param \Symfony\Component\DependencyInjection\ContainerInterface $container
   *   The Drupal service container.
   *
   * @return static
   */
  public static function create(ContainerInterface $container) {
    return new static(
      $container->get('form_builder')
    );
  }

В методе create мы получаем объект Service container и возвращаем объект $form_builder, которые в коде выше в конструкторе мы сохраняем в свойства для объектов (formBuilder). Обратите внимание на регистр переменных для объектов из Service container мы используем lowercase ($form_builder), а для свойств в классе, куда мы эти объекты сохраняем, мы используем camelCase с маленькой буквы (formBuilder).

И теперь мы можем использовать объект из Service Container в методах нашего класса:

  /**
   * Callback for modal form.
   */
  public function openModalForm() {
    ...
    $modal_form = $this->formBuilder->getForm('Drupal\drupalbook\Form\ModalForm');
    ...
  }