Drupal 8 Hello World: Пишем свой первый модуль
Блог

Drupal 8 Hello World: Пишем свой первый модуль

Создаем простой модуль, в котором необходимо писать весь свой код.
24 комментария
Опубликовано 12.10.2014
3 мин.

Если вы заинтересованы в разработке на Drupal с технической стороны, а также вам нравится что будет в Drupal 8, да и вообще какой будет Drupal, то самое время начинать учиться кодить под него. Сейчас как-раз тот период, когда можно без спешки сидеть и изучать всё новое.

В данной статье не будет ничего сверх-необычного и сложного. Мы создадим модуль, с учётом всех структурных изменений, который будет регистрировать страничку и отдавать по ней Hello World.

Для тех кто знаком с Drupal 7

Раздел посвященный для тех кто уже знаком с Drupal 7. Если же вы под него не программировали, можете смело пропускать.

Итак, вы знакомы c программированием под Drupal 7? Это очень хорошо, стартануть будет немного проще, но всё же, грубо говоря, придется учиться заново. Слишком сильно перелопатили ядро. Первым делом, рекомендую выучить основы ООП в php, если вы с ними не знакомы, конечно, ибо они станут первой стеной на пути к изучению. Могу посоветовать небольшой цикл обучающих материалов на Codecademy. Можно за пол часа понять всю суть ООП, как его использовать в php и т.д., а опыт придет уже непосредственно в момент применения этого всего в Drupal 8.

Что касается API, тут всё немного может оказаться для вас печальным. Подавляющее большинство хуков убрали с концами, поэтому это может вызвать на первых этапах непонимание. Учитывая что пока  документация гуглится очень сложно, а среди нагугленного часто попадаются неактуальные, я собираю список изменений среди популярных функций и их замен, возможно окажется полезным.

В остальном же, принципы и идеология остались неизменными. Изменились лишь средства и подходы к разработке, многое упростили, многое усложнили, а некоторое и вовсе убрали, хотя, быть может, это кажется только мне и сейчас, а потом окажется упрощением. Многое может вызывать когнитивный диссонанс, но это нормально, учитывая каким измениям подвергся Drupal.

Общие изменения

В Drupal 8 пересмотрели вообще все. Если идти по пунктикам создания модуля, то изменения начинаются с самых первых пунктов. Теперь модули располагаются не в /sites/all/modules, а в корневой папке /modules.

Все info файлы, а также многие функции, например, hook_menu(), заменены .yml файлами в корне модуля.

Появился стандарт PSR-4, который влияет на структуру папок. Допустим, файлы отвечающие за формы, должны находиться строго по адресу: mymodulename/src/Form, а также подобные мелочи, не учитывая которые, модуль будет работать некорректно. Но к ним привыкаешь после первого же раза, слишком уж мелкие изменения, зато, надо заметить, удобные и правильные. Теперь не будет хаоса в модулях.

Создаем структуру

Для начала выполняем следующие действия:

  1. В корневой папке modules создаем папку для нашего модуля: helloworld. (При условии что наш модуль будет называться helloworld).
  2. Создаем пустой файл helloworld.info.yml.

Эти шаги - набор минимум для создания модуля. Теперь пройдемся по файликам.

helloworld.info.yml

Данный файл, как и в 7 версии, отвечает за базовую информацию о модуле, разница лишь в том, что теперь это всё хранится в новом формате.

Давайте добавим в него следующие строки:

# INFO: Комментарии указываются в yml через хэштег.
# Название модуля (отображается в списке модулей).
name: Hello World
# Описание модуля. Пишется исключительно на английском.
description: 'HelloWorld module - is my first module!'
# Объявляем что это модуль.
type: module
# Версия ядра для которого модуль.
core: 8.x
# Версия модуля.
version: 1.0
# Пакет для модуля. По-сути, просто раздел в модулях где будет распологаться наш модуль.
package: Examples

Более подробно прочитать о .info.yml файлах и что там может быть можно в официальной документации.

На этом базовая подготовка закончена. Модуль должен появится в списке и его уже можно будет включать\удалять.

Создаем страницу с Hello World

Теперь нам необходимо зарегистрировать url нашей будущей страницы и вывести на ней Hello World.

Для начала нам нужно создать контроллер, который будет отвечать за вывод на страницу:

  1. Создаем в корневой папке модуля новую папку: src.
  2. Создаем в папке src новую папку: Controller. Папка так и должна называться с большой буквы.
  3. Теперь создаем файлик с нашим контроллером, его имя уже не особо имеет значения, давайте назовём его: HelloWorldController.php. Название должно начинаться с большой буквы. (ЗАКРЫВАЮЩИЙ ?> не нужен!)
<?php
 /**
  * @file
  * Contains \Drupal\helloworld\Controller\HelloWorldController.
  * ^ Пишется по следующему типу:
  *  - \Drupal - это указывает что данный файл относится к ядру Drupal, ведь
  *    теперь там еще есть Symfony.
  *  - helloworld - название модуля.
  *  - Controller - тип файла. Папка src опускается всегда.
  *  - HelloWorldController - название нашего класса.
  */

/**
 * Пространство имен нашего контроллера. Обратите внимание что оно схоже с тем
 * что описано выше, только опускается название нашего класса.
 */
namespace Drupal\helloworld\Controller;

/**
 * Используем друпальный класс ControllerBase. Мы будем от него наследоваться,
 * а он за нас сделает все обязательные вещи которые присущи всем контроллерам.
 */
use Drupal\Core\Controller\ControllerBase;

/**
 * Объявляем наш класс-контроллер.
 */
class HelloWorldController extends ControllerBase {

  /**
   * {@inheritdoc}
   *
   * В Drupal 8 очень многое строится на renderable arrays и при отдаче
   * из данной функции содержимого для страницы, мы также должны вернуть
   * массив который спокойно пройдет через drupal_render().
   */
  public function helloWorld() {
    $output = array();

    $output['#title'] = 'HelloWorld page title';

    $output['#markup'] = 'Hello World!';

    return $output;
  }

}

Контроллер есть, функция отвечающая за вывод тоже, осталось только зарегистрировать страницу, при обращении на которую будет дергаться наш контроллер. Делается все это роутингами, для этого нам понадобится в корневой папке модуля создать новый файл: helloworld.routing.yml.

Данный файл описывает адреса страниц, и что по их обращению будет сделано. Для тех кто знаком с Drupal 7,  вы увидите сильное сходство с hook_menu() - ведь это на его замену пришли роутинги и в частности, данная функция заменена этим файлом.

Итак, мы создали файл для роутингов, теперь заполним его:

# Первым делом объявляется машинное имя роута. Оно составляетсям из:
# название_модуля.машинное_название_роута.
helloworld.hellopage:
  # Указываем путь роута, с лидирующим слешем.
  path: '/hello'
  # Значения по умолчанию
  defaults:
    # Функция контроллера отвечающая за содержимое.
    _controller: '\Drupal\helloworld\Controller\HelloWorldController::helloWorld'
  # В данном разделе указываются необходимые требования для роута.
  requirements:
    # Мы будем показывать страницу только тем, у кого есть права на просмотр
    # содержимого.
    _permission: 'view content'

Сохраняем. Включаем модуль и заходим по адресу: /hello

BINGO!

Готовый модуль прикреплен к материалу.

Прикрепленные файлы
Drupal
Drupal 8
небольшой уютный чатик

Комментарии

А
Андрей Niklan
сб, 12/27/2014 - 21:39

Как-то они сильно намудрили с API для Drupal 8, с 6 и 7 всё понятно, а тут надо сначала с симфони разобраться... В общем бред, на мой взгляд...

А
Антон
сб, 06/20/2015 - 00:55

Еще что непонятно: в примере роутера используется _permission: 'view content', но он нигде не определен, почему так?

d
documentyCype
пн, 10/19/2015 - 16:23

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

документы за проживание в гостинице

Р
Роман
чт, 12/31/2015 - 14:55

Скажите, а для чего создавать папку src в корневой папке ? Если просто в модуле создать папку Controller, разве так не будет работать ?

А
Андрей
ср, 08/31/2016 - 22:12

А подскажите, пожалуйста, как туда темплейтину свою впихнуть (твиговскую). Я что-то пробовал но не получилось. Где-то что-то не так. Я вроде делал все как надо. Прописывал _theme в модуле, но.... Заранее спасибо.

С
Сергей
вт, 09/26/2017 - 15:08

Обясни мне, начинающему, что не так с роутингом?

http://joxi.ru/E2pMbNWi9qPEWA

Почему пробелы необходимы в моем случае? без них не работает. И вызывает ошибку при чистке кеша. Я сутки проколупался, пока не дотямкал.. писал руками, не вносил пробелы. сравнил с твоим решением - вот в них все дело.

N
Niklan Сергей
вт, 09/26/2017 - 17:33

У yml файлов очень жесткая структура. Пробелы являются отступами иерархии и парсер понимает что к чему принадлежит. Без них, каждая строка без пробелов для него роут. Их обязательно соблюдать. Я не знаю что тут обьяснить ещё, тут проблема не в роуте, а синтаксисе yaml. Грубо говоря, это превращается в массив и используется как необходимо. Если у вас бы вместо массива $array['route.name']['_controller'] пришли два $array['route.name'] и $array['_controller'], вы бы тоже не поняли что за контроллер и к кому он относится.

И
Игорь
вт, 10/31/2017 - 14:08

Напиши, пожалуйста, как работать со своей таблицей в базе данных в своем модуле. В интернетах полно описаний типа $query = \Drupal::database()->update('example'); $query->fields([ 'field_1' => $value_1, 'field_2' => $value_2, 'field_3' => $value_3, ]); $query->condition('field_4', $value_4); $query->execute();

Но они не работают, так как в том же интернете нашел фразу " Однако, если вы создаёте собственный модуль, который оперирует своими таблицами, то операции добавления и изменения придётся описывать вручную." Как это лучше сделать? Заранее благодарен.

A
Agulik
вс, 10/07/2018 - 18:20

Никлан, дорогой, напиши, будь добр, статью про работу с form API, для изменений node edit - изменение полей, добавление новых элементов и ещё чего. На Drupal 7, легко изменял вс что мне угодно было в node edit, а теперь в ступоре. Никак не могу понять, с чего начать и примеров толком нет в буржуйНете. Сейчас, пробую на данном примере добраться до нужного типа материала, чтобы прописать туда свои классы, вставить виртуальное поле autocomplete для "Place Autocomplete Address Form", чтобы из него передавать нужные мне значения в поля таксономии (Страна, Регион, Город) ибо готовых решений нет. У тебя прекрасно получается совмещать талант разработчика и писателя :) Очень благодарен тебе за тот формат подачи материала с прикреплёнными файлами - ты миссионер Drupal 8 ни только в России, но и во всём, русскоговорящем обществе. Благодарю тебя, Человечище :) Drupal 8 - это нечто. Я все личные проекты переношу на него, после этого, на Семерку сложно смотреть

N
Niklan Agulik
пн, 10/08/2018 - 09:26

Не очень понимаю в чем проблема. В 8-у Form API перехал из 7-и без изменений. Ну может вообще в каких-то мелочах, но в целом он такой же. Даже хуки остались те же.

То что вы описываете, попахивает Field Widget Plugin, а не альтером форм редактирования нод. Рекомендую просто глянуть пример виджета тут: https://niklan.net/blog/132