Drupal 11.3: Обзор ключевых изменений

В этом обзоре я собрал самые интересные для меня изменения в Drupal 11.3. Полный список обновлений вы найдёте на странице релиза¹.

Добавлена поддержка ООП-хуков в темах¶

Теперь темы поддерживают ООП-хуки.³ Подход в целом такой же, как в модулях, но есть несколько особенностей:

• Параметры $module и $order атрибута #[Hook] не поддерживаются. Поэтому темы не могут регистрировать хуки от лица других модулей или тем. Точно так же модули не могут регистрировать хуки от лица какой-либо темы.
• В темах недоступны атрибуты #[ReorderHook] (нельзя менять порядок выполнения хуков) и #[RemoveHook] (нельзя удалять сторонние хуки).
• Порядок выполнения хуков фиксированный: модули → базовая тема → основная тема.
• Для темы доступны только те альтер-хуки, которые проходят через Drupal\Core\Theme\ThemeManagerInterface::alter() / ::alterForTheme().

Представлен объектно-ориентированный API для работы с определёнными типами рендер-массивов¶

В ядре сделаны первые шаги по переводу рендер-массивов на объектно-ориентированный подход. Первыми элементами, переведёнными на ООП, стали:

• Элементы форм (#[FormElement])⁴
• Рендер-элементы (#[RenderElement])⁴
• Виджеты полей (#[FieldWidget])⁵

Изменение позволяет работать с этими структурами как с классами. Это даёт возможность использовать преимущества ООП в IDE: подсказки и автодополнение. Полный отказ от рендер-массивов планируется к релизу Drupal 13.

Основная идея: сервис Drupal\Core\Render\ElementInfoManagerInterface теперь предоставляет структуры рендер-элементов. Они служат основой для форм и активно применяются при их создании.

use Drupal\Core\Render\Element\Details;
use Drupal\Core\Render\Element\Email;
use Drupal\Core\Render\Element\Submit;
use Drupal\Core\Render\Element\Textfield;
use Drupal\Core\Render\ElementInfoManagerInterface;
use Drupal\Core\StringTranslation\TranslatableMarkup;

$form_render_array = [
  'foo' => [
    '#type' => 'textfield',
  ],
  'actions' => [
    '#type' => 'actions',
  ],
];

$element_info_manager = $container->get(ElementInfoManagerInterface::class);

$form = $element_info_manager->fromRenderable($form_render_array);
$form->removeChild('foo');

$textfield = $element_info_manager->fromClass(Textfield::class);
$textfield->default_value = new TranslatableMarkup('Hello, World!');
$textfield->required = TRUE;
$form->addChild('bar', $textfield);

$email_wrapper = $form->createChild('email_wrapper', Details::class);
$email_wrapper->open = TRUE;

$email = $email_wrapper->createChild('email', Email::class);
$email->placeholder = new TranslatableMarkup('Enter your email address');
$email->required = TRUE;

$actions = $form->getChild('actions');
$submit = $actions->createChild('submit', Submit::class);
$submit->button_type = 'primary';
$submit->value = new TranslatableMarkup('Submit');

$form_render_array = $form->toRenderable();

Чтобы добавить необходимую информацию в собственные рендер-элементы, необходимо указывать свойства элемента в PHPDoc через @property-нотацию.

use Drupal\Core\Render\Attribute\RenderElement;
use Drupal\Core\Render\Element\RenderElementBase;

/**
 * @property string|null $my_property
 * @property array<string> $another_property
 */
#[RenderElement('my_element')]
final class MyElement extends RenderElementBase {

  public function getInfo(): array {
    return [
      '#my_property' => NULL,
      '#another_property' => [],
    ];
  }

}

Добавлена поддержка HTMX¶

В ядре началась работа по внедрению HTMX. Постепенно он заменит AJAX-подсистему и возьмёт на себя её функции. HTMX⁶⁷ — декларативная система разметки, которая расширяет возможности HTML с помощью специальных атрибутов.

Основные изменения:

• Новый класс Drupal\Core\Htmx\Htmx — для работы с атрибутами и заголовками HTMX.⁸
• Класс Drupal\Core\Render\Hypermedia\HtmxLocationResponseData — для управления данными.⁸
• Поддержка HTMX-запросов в FormBuilder.⁸
• Интеграция HTMX с AJAX-подсистемой.⁸
• Новый формат обёртки drupal_htmx (Drupal\Core\Render\MainContent\HtmxRenderer) — для ответов с использованием HTMX.⁸
• Добавлена новая опция маршрута (_htmx_route) — для маршрутов, обрабатывающих HTMX-запросы (drupal_htmx, упомянутый выше).⁹
• Добавлен новый трейт Drupal\Core\Htmx\HtmxRequestInfoTrait.¹⁰ Он помогает классам формировать рендер-массивы для HTMX.
• Форма ConfigSingleExportForm теперь динамически обновляет URL — это происходит в зависимости от её состояния.¹¹

Пока у меня нет опыта работы с HTMX, поэтому сложно оценить его практическую пользу. Однако инструмент теоретически хорошо подходит для ленивой подгрузки тяжёлых данных с бэкенда. Принцип прост: когда элемент попадает в область видимости, он заменяется содержимым. Вся реализация остаётся на бэкенде — писать JavaScript не требуется.

Вот пример: обычная форма становится AJAX-формой. Валидация и отправка происходят без перезагрузки страницы. Если всё прошло успешно, форма заменяется сообщением об успешной отправке.

use Drupal\Core\EventSubscriber\MainContentViewSubscriber;
use Drupal\Core\Form\FormInterface;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Htmx\Htmx;
use Drupal\Core\StringTranslation\TranslatableMarkup;
use Drupal\Core\Url;

final readonly class HtmxForm implements FormInterface {

  public function getFormId(): string {
    return 'example_htmx';
  }

  public function buildForm(array $form, FormStateInterface $form_state): array {
    $form_url = Url::fromRoute('<current>', options: [
      'query' => [MainContentViewSubscriber::WRAPPER_FORMAT => 'drupal_htmx'],
    ]);
    (new Htmx())->post($form_url)->target('this')->swapOob(TRUE)->applyTo($form);

    $form['status_messages'] = [
      '#type' => 'status_messages',
      '#weight' => -1000,
    ];

    $form['email'] = [
      '#type' => 'email',
      '#title' => new TranslatableMarkup('Email address'),
      '#required' => TRUE,
      '#placeholder' => 'example@example.com',
    ];

    $form['actions']['#type'] = 'actions';
    $form['actions']['submit'] = [
      '#type' => 'submit',
      '#value' => new TranslatableMarkup('Submit'),
    ];

    return $form;
  }

  public function validateForm(array &$form, FormStateInterface $form_state): void {
    if ($form_state->getValue('email') === 'example@example.com') {
      return;
    }

    $form_state->setError($form['email'], new TranslatableMarkup('You have entered the wrong email address.'));
  }

  public function submitForm(array &$form, FormStateInterface $form_state): void {
    $form = [];
    $form['success'] = [
      '#theme' => 'status_messages',
      '#message_list' => [
        'status' => [
          new TranslatableMarkup('Form successfully submitted.'),
        ],
      ],
      '#status_headings' => [
        'status' => new TranslatableMarkup('Success'),
      ],
    ];
  }

}

Добавлена встроенная CLI-утилита и API для экспорта содержимого в YAML-формате¶

Теперь можно экспортировать контентные сущности в YAML-формате с помощью встроенной CLI-утилиты и API.¹²¹³ Раньше для этого требовался сторонний модуль, например Default Content¹⁴.

Для экспорта конкретных сущностей используйте новую команду:

php web/core/scripts/drupal content:export <entity_type_id> <entity_id>

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

php web/core/scripts/drupal content:export node 19 > node-19.yml

default:
  revision_uid:
    -
      entity: ec6b7ed6-2a25-412b-884b-608493045a7f
  status:
    -
      value: true
  uid:
    -
      entity: ec6b7ed6-2a25-412b-884b-608493045a7f
  title:
    -
      value: 'About Umami'
  promote:
    -
      value: false
  sticky:
    -
      value: false
  moderation_state:
    -
      value: published
  path:
    -
      alias: /about-umami
      langcode: en
  content_translation_source:
    -
      value: und
  content_translation_outdated:
    -
      value: false
  field_body:
    -
      value: '<p>Umami is a fictional food magazine that has been created to demonstrate how you might build a Drupal site using functionality provided ''out of the box''.</p><p>For more information visit <a href="https://www.drupal.org/docs/umami-drupal-demonstration-installation-profile">https://www.drupal.org/docs/umami-drupal-demonstration-installation-profile</a>.</p>'
      format: basic_html
translations:
  es:
    revision_uid:
      -
        entity: ec6b7ed6-2a25-412b-884b-608493045a7f
    status:
      -
        value: true
    uid:
      -
        entity: ec6b7ed6-2a25-412b-884b-608493045a7f
    title:
      -
        value: 'Acerca de Umami'
    promote:
      -
        value: false
    sticky:
      -
        value: false
    revision_translation_affected:
      -
        value: true
    moderation_state:
      -
        value: published
    path:
      -
        alias: /acerca-de-umami
        langcode: es
    content_translation_source:
      -
        value: und
    content_translation_outdated:
      -
        value: false
    field_body:
      -
        value: '<p> Umami es una revista ficticia de alimentos que se ha creado para demostrar cómo se puede construir un sitio de Drupal con la funcionalidad que se proporciona ''fuera de la caja''. </p> <p> Para obtener más información, visite <a href="https://www.drupal.org/docs/umami-drupal-demonstration-installation-profile">https://www.drupal.org/docs/umami-drupal-demonstration-installation-profile</a>.</p> '
        format: basic_html
_meta:
  version: '1.0'
  entity_type: node
  uuid: 7889c36d-3ba6-4e32-8f15-d290925c46e0
  bundle: page
  default_langcode: en
  depends:
    ec6b7ed6-2a25-412b-884b-608493045a7f: user

Если вы хотите выгрузить данные в определённую директорию, используйте опцию --dir:

php web/core/scripts/drupal content:export node 123 --dir=content

Эта команда сохранит содержимое по пути content/node/{UUID}.yml. Опционально можно добавить опцию --with-dependencies, в таком случае будут также выгружены и все зависимости экспортируемой сущности в формате: {dir}/{entity_type_id}/{uuid}.yml.

Для программного экспорта данных используйте новый сервис Drupal\Core\DefaultContent\Exporter.

use Drupal\Core\DefaultContent\Exporter;
use Drupal\node\Entity\Node;

$exporter = $container->get(Exporter::class);
// Экспорт в массив.
$content_structure = $exporter->export($entity_storage->load(19));
// Экспорт в директорию.
$exporter->exportToFile($entity_storage->load(19), 'content');
// Экспорт в директорию со всеми зависимостями.
$exporter->exportWithDependencies($entity_storage->load(19), 'content');

Также добавлено новое событие Drupal\Core\DefaultContent\PreExportEvent, позволяющее управлять экспортом данных. Оно даёт возможность:

• Настраивать включение/исключение ключей сущностей (uuid, langcode, status и т.д.) через метод ::setEntityKeyExportable();
• Контролировать экспорт отдельных полей с помощью метода ::setExportable();
• Влиять на результат экспорта через функцию обратного вызова в методе ::setCallback(), который обрабатывает каждое значение поля отдельно.

Метод ::setCallback() работает в двух режимах:

• При совпадении параметра $name_or_data_type с названием поля — управляет экспортом конкретного поля;
• При указании типа поля через префикс field_item: (например, field_item:entity_reference) — применяет настройки ко всем полям этого типа.

use Drupal\commerce_price\Plugin\Field\FieldType\PriceItem;
use Drupal\Core\DefaultContent\ExportMetadata;
use Drupal\Core\DefaultContent\PreExportEvent;
use Drupal\Core\Field\FieldItemInterface;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

final readonly class FooSubscriber implements EventSubscriberInterface {

  public static function getSubscribedEvents(): array {
    return [PreExportEvent::class => 'preExport'];
  }

  public function preExport(PreExportEvent $event): void {
    $entity = $event->entity;
    if ($entity->getEntityTypeId() !== 'commerce_product_variation') {
      return;
    }

    // Обратите внимание, что здесь именно ключ, а не его синоним.
    // @code
    // …
    // entity_keys: [
    //   'owner' => 'uid',
    // ],
    // …
    // @endcode
    $event->setEntityKeyExportable('owner', FALSE);
    // По умолчанию UUID скрывается.
    $event->setEntityKeyExportable('uuid');

    $event->setExportable('field_in_stock', FALSE);
    $event->setExportable('field_primary_category');

    $event->setCallback('field_item:commerce_price', $this->formatPrice(...));
  }

  private function formatPrice(FieldItemInterface $item, ExportMetadata $metadata): void {
    \assert($item instanceof PriceItem);
    return $item->get('formatted')->getValue();
  }

}

Добавлен экспериментальный MySQLi драйвер для асинхронных запросов к базе данных¶

Добавлен экспериментальный драйвер MySQLi¹⁶ для MySQL/MariaDB, использующий PHP-расширение mysqli.¹⁷ Планируется задействовать Revolt¹⁸ PHP event loop для ускорения операций (например, загрузка сущностей с множеством полей, сложных представлений). Драйвер скрыт и предназначен только для тестирования.

  $databases['default']['default'] = [
    // Прочие настройки, такие как подключение к базе данных, неизменны.
    'driver' => 'mysqli',
    'namespace' => 'Drupal\\mysqli\\Driver\\Database\\mysqli',
    'autoload' => 'core/modules/mysqli/src/Driver/Database/mysqli/',
    'dependencies' => [
      'mysql' => [
        'namespace' => 'Drupal\\mysql',
        'autoload' => 'core/modules/mysql/src/',
      ],
    ],
  ];

Если вдруг «зачесались» руки проверить «ускорение» — не тратьте время. Я уже всё проверил.

Грубый тест производительности с использованием demo_umami профиля (siege -c 10 -t 60s --no-parser --no-follow [URL] с отключёнными кешами: render, entity, data, page, dynamic_page_cache):

• Главная страница:
  • mysql → 235 мс
  • mysqli → 283 мс
  • Итог: замедление ~20%
• Страница статей (/en/articles):
  • mysql → 219 мс
  • mysqli → 260 мс
  • Итог: замедление ~18%
• Страница рецепта (/en/recipes/borscht-with-pork-ribs):
  • mysql → 248 мс
  • mysqli → 320 мс
  • Итог: замедление ~29%

Я также скопировал 10 000 статей с переводами, затем измерил скорость загрузки всех сущностей (повторюсь — без кеша entity).

use Drupal\Component\Utility\Timer;
use Drupal\Core\Cache\MemoryCache\MemoryCacheInterface;
use Drupal\Core\Entity\EntityTypeManagerInterface;

$iterations = 10;
Timer::start('mysql-v-mysqli');
for ($i = 0; $i < $iterations; $i++) {
  $container->get(EntityTypeManagerInterface::class)->getStorage('node')->loadMultiple();
  $container->get(MemoryCacheInterface::class)->deleteAll();
}
Timer::stop('mysql-v-mysqli');

echo Timer::read('mysql-v-mysqli') / $iterations;

Для mysql время выполнения составило 1218 мс, а для mysqli — 1533 мс. Это замедление примерно на 25%.

Текущая версия драйвера — основа для будущих оптимизаций. Даже если использовать Event Loop для запросов в вашем коде, останется проблема множества запросов от Drupal и сторонних модулей. Пока зафиксируем добавление драйвера и подождём дополнительных улучшений.

Дополнительные улучшения и изменения¶

API и разработка¶

• Добавлен метод ::mergeWith() в класс AjaxResponse. Он позволяет объединять AJAX-команды из разных экземпляров AjaxResponse в один ответ.¹⁹
• Добавлена поддержка сокращённого синтаксиса @> вместо !service_closure в YAML-файлах сервисов.²⁰
• Метод EntityController::addPage() теперь ожидает новый параметр $request.²¹
• Для AJAX-представлений добавили команду, которая устанавливает URL в браузере без перезагрузки страницы.²²
• Добавлено событие WorkspaceSwitchEvent для реагирования на смену активного рабочего пространства.²³
• Класс Drupal\taxonomy\Form\OverviewTerms теперь наследуется от Drupal\Core\Entity\EntityForm. Это улучшает расширяемость формы обзора терминов словарей.²⁴
• Добавлены новые синонимы для маршрутов: node.add → entity.node.add_form и node.add_page → entity.node.add_page.²⁵ Это сделано в рамках стандартизации генерации маршрутов.
• Добавлена фабрика (сервис: config.importer.factory) для создания объекта ConfigImporter.²⁶
• В интерфейс Drupal\Core\State\StateInterface добавлен метод ::getValuesSetDuringRequest(). Он позволяет отследить, как менялись значения в пределах одного HTTP-запроса.²⁷
• Batch API теперь использует CallableResolver для обработки функций обратного вызова.²⁸ Это позволяет применять сервисы для операций пакетной обработки.
• Form API теперь также использует CallableResolver для обработки функций обратного вызова.²⁹
• В класс Drupal\Component\Utility\SortArray добавлен статический метод ::sortByKeyRecursive(). Он выполняет рекурсивную сортировку массивов по ключам.³⁰
• Обработчики форм в определениях типов сущностей и маршрутах с параметром _entity_form теперь должны явно реализовывать интерфейс Drupal\Core\Entity\EntityFormInterface.³¹
• Введен новый интерфейс Drupal\Core\Validation\CompositeConstraintInterface, который служит мостом между составными ограничениями Symfony и Drupal.³²
• Добавлено новое ограничение Sequentially для последовательной валидации с показом только первой ошибки.³³
• Добавлен опциональный обработчик link_target для типов сущностей, позволяющий единообразно генерировать URL-адреса при создании ссылок.³⁴
• Добавлены stream wrapper'ы module:// и theme:// для удобного обращения к файлам в модулях и темах с автоматической проверкой доступности расширений.³⁵
• Добавлено событие PreEntityImportEvent, позволяющее изменять данные сущности перед созданием в процессе импорта содержимого.³⁶
• Добавлен новый плагин автодополнения сущностей для полей-ссылок на сущности типа block_content. Теперь блоки, которые не помечены как «Переиспользуемый», автоматически исключаются из результатов автодополнения.³⁷

Производительность и кеширование¶

• Теперь автоматически генерируется класс Drupal\DrupalInstalled. Он содержит хеш всех установленных зависимостей проекта в константе VERSIONS_HASH.³⁸ Это значение будет использоваться для генерации ID кеша контейнера. При изменении кодовой базы и её зависимостей, будет создан новый контейнер.
• Работа Page Cache Middleware была оптимизирована благодаря использованию Service Closure.³⁹ Это позволяет ускорить обработку кешированных страниц.
• Метод EntityStorageBase::loadMultiple() теперь использует Fiber'ы⁴⁰ для ленивой загрузки нескольких сущностей.⁴¹
• Удалён устаревший кеш предзагрузки синонимов путей. Вместо него внедрён новый механизм, который основан на Fiber'ах⁴⁰ и предназначен для оптимизации загрузки синонимов.⁴²
• Введен новый кеш-контейнер (cache bin) — cache.memory.⁴³ Он заменяет устаревший cache.static.
• Блоки, которые реализуют интерфейс Drupal\Core\Cache\CacheOptionalInterface, не будут иметь собственных записей в рендер-кеше. Благодаря этому можно будет кешировать страницы с такими блоками в динамическом кеше.⁴⁴
• Метод ContentEntityStorageBase::loadRevision() теперь включает механизмы статического и постоянного кеширования.⁴⁵
• Логика управления памятью в MigrateExecutable была удалена. Теперь для статического кеширования сущностей применяется LRU-кеш⁴⁶.⁴⁷
• Для оптимизации работы с Fiber'ами добавлено перечисление FiberResumeType. Оно позволяет указать, что приостановленный Fiber может быть немедленно возобновлён.⁴⁸
• Теперь метод MemoryBackend::garbageCollection() реализует очистку кеша. Он удаляет из памяти элементы, помеченные как невалидные (например, с истекшим сроком действия).⁴⁹ Раньше этот метод был пустым. Из-за этого в оперативной памяти постоянно накапливались неиспользуемые данные — невалидные записи не удалялись автоматически.
• Работа системы хуков изменена: теперь хуки не выступают в роли слушателей событий.⁵⁰ Такое изменение помогает улучшить производительность системы.

Устаревшая функциональность и изменения в обратной совместимости¶

• Метод FileSystemInterface::basename() признан устаревшим. Теперь рекомендуется использовать нативную PHP-функцию basename().⁵¹
• Хук hook_ranking() признан устаревшим. В качестве замены введена функция hook_node_search_ranking().⁵²
• Классы, трейты, плагины и компоненты, связанные с миграцией данных из старых версий Drupal, признаны устаревшими. Это сделано в рамках подготовки к полному удалению модуля Drupal Migrate в Drupal 12.⁵³⁵⁴
• Модуль Migrate Drupal UI, предоставляющий пользовательский интерфейс для миграции данных из предыдущих версий Drupal, объявлен устаревшим.⁵⁵
• Многочисленные плагины миграции объявлены устаревшими.⁵⁶ Они предназначены для переноса данных с устаревших версий Drupal.
• Библиотеки comment/drupal.comment-new-indicator и comment/drupal.node-new-comments-link объявлены устаревшими и заменены на аналоги из модуля history.⁵⁷
• Рефакторинг модуля Responsive Image: устаревшие функции заменены методами сервиса ResponsiveImageBuilder для улучшения структуры кода и перехода на ООП-подход.⁵⁸
• Маршрут comment.new_comments_node_links и метод контроллера Drupal\comment\Controller\CommentController::renderNewCommentsNodeLinks объявлены устаревшими.⁵⁹ Вместо них рекомендуется использовать новый маршрут history.new_comments_node_links и метод Drupal\history\Controller\HistoryController::renderNewCommentsNodeLinks.
• Метод WorkspaceManagerInterface::purgeDeletedWorkspacesBatch() объявлен устаревшим без замены.⁶⁰
• Функция _system_default_theme_features() объявлена устаревшей.⁶¹
• Метод theme_get_setting() объявлен устаревшим; вместо него нужно использовать сервис Drupal\Core\Extension\ThemeSettingsProvider.⁶²
• Методы ModuleHandler::addProfile() и ModuleHandler::addModule() больше не выполняют никаких действий и запланированы к удалению в Drupal 12.⁶³
• Функция file_managed_file_submit() объявлена устаревшей и заменена методом \Drupal\file\Element\ManagedFile::submit().⁶⁴
• Объявлено устаревшим расширение .engine для шаблонизаторов. Теперь шаблонизаторы должны реализовываться как сервисы с меткой theme_engine.⁶⁵
• Сервис workspaces.association объявлен устаревшим, добавлен новый сервис workspaces.tracker.⁶⁶
• Вызов метода Drupal\Core\Entity\EntityTypeBundleInfo::getBundleInfo() с нестроковым идентификатором типа сущности (например, NULL) объявлен устаревшим.⁶⁷
• Объявлено устаревшим сопоставление NULL-значений через пустой ключ в плагине StaticMap без указания значения по умолчанию или опции bypass.⁶⁸
• Объявлен устаревшим модуль Field Layout.⁶⁹
• Метод Drupal\comment\CommentManagerInterface::getCountNewComments() объявлен устаревшим. Рекомендуется использовать Drupal\history\HistoryManager::getCountNewComments().⁷⁰ Токен comment-count-new перемещён из модуля comment в модуль history.
• Удален кастомный валидатор AtLeastOneOfConstraintValidator в пользу стандартной реализации Symfony.⁷¹
• Пакет doctrine/annotations был форкнут в ядро Drupal для поддержки устаревшего функционала аннотаций до версии Drupal 13.⁷²
• Следующие классы объявлены устаревшими: ArchiverException, ArchiverInterface, ArchiverManager, Tar, Zip.⁷³ Класс ArchiveTar (обёртка вокруг PEAR Archive_Tar) остаётся доступным для использования в интерфейсе импорта и экспорта конфигурации.
• Обращение к $this->container в функциональных тестах теперь объявлено устаревшим.⁷⁴
• Вызов метода FieldStorageDefinitionInterface::getPropertyDefinition() с параметром $name, равным NULL, теперь объявлен устаревшим.⁷⁵
• Функция content_translation_field_sync_widget и файл content_translation.admin.inc объявлены устаревшими. Теперь следует использовать сервис FieldSyncWidget.⁷⁶
• Метод ImageStyle::getReplacementID() объявлен устаревшим, поскольку он не используется.⁷⁷ Теперь для получения ID замены нужно обращаться к хранилищу сущностей.
• Единый хук hook_requirements() объявлен устаревшим. Теперь для проверок системных требований на разных этапах работы сайта введены отдельные хуки и интерфейс.⁷⁸
• Модуль Contact больше не входит в состав Standard⁷⁹ и Demo Umami⁸⁰ профилей. В будущем его планируют пометить как устаревший и перевести в разряд контрибных модулей.⁸¹

Пользовательский интерфейс и UX¶

• Поля «Помещено на главную страницу» (Promoted) и «Закреплять вверху списков» (Sticky) по умолчанию скрыты для всех новых типов содержимого.⁸² При этом сами поля не изменились — вы можете вернуть их в форму редактирования материала через раздел «Управление отображением формы» для нужного типа материала.
• Теперь можно управлять порядком элементов в верхней панели (top bar в navigation).⁸³
• Если ограничение размера файла не задано, его отображение при загрузке удалено.⁸⁴
• Появился новый фильтр Entity Links и плагин для CKEditor 5. Они позволяют создавать ссылки на сущности через автодополнение.⁸⁵
• Для Single-Directory Components (SDC) добавлено свойство noUi. Оно позволяет скрывать компоненты в интерфейсах конструкторов страниц.⁸⁶

Темы и фронтенд¶

• Добавлена возможность помечать устаревшие suggestions для тем-хуков с указанием сообщения об их замене или удалении в будущих версиях.⁸⁷
• Добавлена поддержка рендер-массивов и MarkupInterface внутри Twig-тега {% trans %}.⁸⁸ Теперь эти типы данных можно безопасно использовать в переводах — раньше это вызывало ошибки и предупреждения.
• Переход на использование yield в рендеринге Twig — это подготовка к Twig 4 и поддержка асинхронной обработки.⁸⁹
• Объявлены устаревшими функции предварительной обработки шаблонов (template_preprocess_HOOK), а также ключи file и includes в определениях hook_theme().⁹⁰
• Введено новое средство для разрешения доступа Twig-шаблонов к методам объектов — атрибут #[TwigAllowed].⁹¹
• Для панели инструментов Navigation и верхней панели административного интерфейса добавлен CSS-сброс.⁹² Это поможет предотвратить влияние стилей внешней темы на их оформление.

Содержимое и структура данных¶

• Улучшено обновление временных меток: при публикации рабочего пространства (модуль Workspace) временная метка изменения автоматически обновляется для всех связанных сущностей.⁹³

Модули и расширяемость¶

• Валидация для конфигурации core.extension улучшена — добавлены ограничения для проверки корректности данных.⁹⁴
• Теперь хуки-функции относятся к текущему модулю, а не к наиболее специфичному соответствию, как было раньше.⁹⁵
• Создание плагинов стало проще благодаря внедрению автосвязывания.⁹⁶ Теперь для указания зависимостей можно использовать аттрибуты вместо явного определения метода create().⁹⁷
• Добавлена система Workspace Provider. Это плагин-подобная архитектура, основанная на сервисах с метками, которая позволяет создавать пользовательские типы рабочих пространств (workspaces) с особым поведением.⁹⁸
• Теперь плагины, которые используются сущностями с коллекцией плагинов, могут реагировать на удаление зависимостей этих сущностей.⁹⁹
• Модуль Navigation стал стабильным.¹⁰⁰

Конфигурация и развертывание¶

• Добавлена возможность отключить автоматическое создание файлов .htaccess с помощью параметра $settings['auto_create_htaccess'] = FALSE.¹⁰¹ Это пригодится для сайтов, которые не используют Apache или уже имеют защиту директорий (например, sites/default/files) на уровне сервера.
• Добавлена возможность исключать отдельные пакеты из процесса очистки с помощью плагина drupal/core-vendor-hardening в Composer.¹⁰²
• Удалена возможность настраивать пути к Composer и rsync через конфигурацию (package_manager.settings:executables). Вместо этого в settings.php добавлены новые параметры — package_manager_composer_path и package_manager_rsync_path. Они позволяют явно указывать пути, что повышает безопасность.¹⁰³
• Теперь при переключении сайта в режим обслуживания или выходе из него в лог по умолчанию (default) записывается соответствующее сообщение.¹⁰⁴
• Экспортёр стандартного содержимого (default content) теперь по умолчанию пропускает поля типа created при генерации экспорта.¹⁵

Тестирование и качество кода¶

• Введено обязательное требование использовать атрибут #[RunTestsInSeparateProcesses] для всех Kernel, Functional и FunctionalJavascript тестов.¹⁰⁵
• Добавлена возможность использования hook-атрибутов для объявления реализаций хуков в Kernel-тестах.¹⁰⁶
• Удалена поддержка PHPUnit 10 — теперь для тестирования можно использовать только PHPUnit 11.¹⁰⁷

Доступ и разрешения¶

• Теперь доступно новое разрешение rebuild node access permissions, которое позволяет перестроить разрешения для типов материалов (node).¹⁰⁸ Раньше для этого нужно было иметь разрешение administer nodes.
• Введено новое разрешение administer node published status. Оно даёт пользователям определённой роли возможность переключать флажок «Опубликовано» при редактировании материалов.¹⁰⁹

Многоязычность и интернационализация¶

• Атрибут hreflang в блоке переключения языков заменён на data-drupal-language.¹¹⁰

Системные требования и совместимость¶

• Выполнены работы по обеспечению совместимости кодовой базы с PHP 8.5¹¹¹.
• Рекомендованная версия PHP — 8.4¹¹².¹¹³
• Классы подключения к базе данных (БД) для PHP 8.4+ обновлены. Для обновления использовались PDO-драйверы: Pdo\Mysql, Pdo\Pgsql, Pdo\Sqlite.¹¹⁴ Благодаря этому устранены предупреждения об устаревании в PHP 8.5 и обеспечена совместимость
• Несовместимость Single Directory Components (SDC) с Windows устранена. Для этого в именах файлов кеша Twig двоеточия заменили на подчёркивания.¹¹⁵