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

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

Default Admin — новая административная тема на основе Gin¶

Контрибутная тема Gin² интегрирована в ядро под названием Default Admin (машинное имя default_admin).³⁴⁵ Тема имеет экспериментальный статус.⁶ Claro по-прежнему остаётся административной темой по умолчанию, но по первоначальному плану её удалят в Drupal 12 и сделают Default Admin новой стандартной темой.

Новая тема оформления предлагает значительно улучшенную версию Claro с новыми функциями.

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

Добавлен экспериментальный модуль mailer для интеграции Symfony Mailer¶

Добавлен экспериментальный модуль mailer для интеграции Symfony Mailer⁷ в Drupal.⁸ Он позволяет использовать современные транспорты (SMTP, Sendmail и другие), настраивать параметры отправки через DSN и перехватывать письма в тестах.

Знакомо, не правда ли? Ещё в 2023 году в Drupal 10.2⁹ добавили зависимость symfony/mailer и соответствующий #[Mail]-плагин.¹⁰ С тех пор компонент можно было использовать при необходимости, но его возможности были сильно ограничены.

Новый модуль расширяет возможности, предоставляя сервисы для отправки, модификации сообщений и кастомизации процессов:

• Для тестирования добавлен модуль mailer_capture, который перехватывает отправленные письма.¹¹
• Основные сервисы для работы с почтой:
  • Symfony\Component\Mailer\MailerInterface — отправка сообщений.
  • Сервис Symfony\Component\Mailer\Transport\TransportInterface — прямая отправка в обход Messenger¹².
• Кастомизация транспортов:
  • Фабрика Drupal\Core\Mailer\TransportServiceFactoryInterface для замены или модификации транспортов.
  • Абстрактный сервис Symfony\Component\Mailer\Transport\AbstractTransportFactory для создания сторонних транспортов через сервисы с метками mailer.transport_factory.
• События для обработки писем:
  • Symfony\Component\Mailer\Event\MessageEvent¹³ — изменение содержимого сообщения перед отправкой.
  • Symfony\Component\Mailer\Event\SentMessageEvent¹⁴ — получение данных об успешной отправке: оригинал сообщения, отладочная информация, идентификатор.
  • Symfony\Component\Mailer\Event\FailedMessageEvent¹⁵ — обработка ошибок с информацией о сообщении и тексте ошибки.
• Новая настройка mailer_sendmail_commands ограничивает доступные команды sendmail. При попытке использовать неразрешённые команды система выбрасывает исключение о небезопасной отправке сообщения.

use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
use Symfony\Component\Mailer\MailerInterface;
use Symfony\Component\Mime\Email;

final readonly class Foo {

  public function __construct(private MailerInterface $mailer, private LoggerInterface $logger) {}

  public function doSomething(): void {
    // Прочая логика…
    try {
      $this->sendEmail();
    }
    catch (TransportExceptionInterface $exception) {
      $this->logger->error($exception->getMessage());
    }
  }

  private function sendEmail(): void {
    $email = new Email()
      ->subject('Hello, World!')
      ->from('webmaster@example.com')
      ->to('you@example.com')
      ->text('Hello, World! This is a test email.')
      ->attachFromPath('/path/to/file.pdf', 'file.pdf', 'application/pdf');

    $this->mailer->send($email);
  }

}

Листинг 1 демонстрирует, что отправка сообщений существенно отличается от стандартных методов в Drupal. Это вызывает закономерные вопросы. Например, как перехватывать письма определённого модуля или типа? Модуль не даёт ответа на этот вопрос. Похоже, нас подталкивают к созданию собственных типизированных Email-классов. Пример:

use Drupal\commerce_order\Entity\OrderInterface;
use Symfony\Component\Mime\Email;

final class CommerceOrderReceiptEmail extends Email {

  public function __construct(public OrderInterface $order) {}

}

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

К слову о событиях — приведу небольшой пример их использования:

use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Drupal\Core\Render\RendererInterface;
use Psr\Log\LoggerInterface;
use Symfony\Component\Mailer\Event\FailedMessageEvent;
use Symfony\Component\Mailer\Event\MessageEvent;
use Symfony\Component\Mailer\Event\SentMessageEvent;
use Symfony\Component\Mime\Email;

final readonly class EmailSubscriber implements EventSubscriberInterface {

  public function __construct(private RendererInterface $renderer, private LoggerInterface $logger) {}

  public static function getSubscribedEvents(): array {
    return [
      MessageEvent::class => 'onMessagePrepare',
      SentMessageEvent::class => 'onMessageSent',
      FailedMessageEvent::class => 'onMessageFailed',
    ];
  }

  public function onMessagePrepare(MessageEvent $event): void {
    $message = $event->getMessage();
    if (!$message instanceof Email) {
      return;
    }

    $email_wrapper = [
      '#theme' => 'email_wrapper',
      '#message' => $message,
    ];
    $email_html = $this->renderer->renderInIsolation($email_wrapper);
    $message->html($email_html);
  }

  public function onMessageSent(SentMessageEvent $event): void {
    if (!$event->getMessage()->getOriginalMessage() instanceof Email) {
      return;
    }

    $this->logger->info('Email was successfully sent.', ['message_id' => $event->getMessage()->getMessageId()]);
  }

  public function onMessageFailed(FailedMessageEvent $event): void {
    if (!$event->getMessage() instanceof Email) {
      return;
    }

    $this->logger->error('Email was not sent.', [
      'message' => $event->getMessage(),
      'error' => $event->getError()->getMessage(),
    ]);
  }

}

Пример с HTML-обёрткой в листинге 2 отправит HTML «как есть» — без инъекции inline-стилей и других преобразований. Для этого потребуются сторонние решения и зависимости¹⁶.¹⁷

Поддержка #[MapQueryParameter] для маппинга query-параметров в контроллерах¶

Добавлена поддержка атрибута Symfony #[MapQueryParameter],¹⁸ который упрощает работу с query-параметрами в контроллерах. Теперь не нужно вручную извлекать параметры из объекта Request — достаточно объявить типизированные аргументы метода, и Symfony автоматически выполнит маппинг и приведение типов.

Рассмотрим практический пример — контроллер каталога товаров с фильтрацией. URL может выглядеть так: /catalog?min_price=1000&sort=price_asc.

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\JsonResponse;

public function catalog(Request $request): JsonResponse {
  $min_price = $request->query->get('min_price');
  $max_price = $request->query->get('max_price');
  $sort = $request->query->get('sort', 'name_asc');

  // Ручная валидация параметров.
  if ($min_price !== null && !is_numeric($min_price)) {
    throw new \InvalidArgumentException('Invalid min_price value');
  }

  // Загрузка и фильтрация товаров…
  $products = $this->loadProducts((int) $min_price, (int) $max_price, $sort);

  return new JsonResponse(['products' => $products]);
}

use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpKernel\Attribute\MapQueryParameter;

public function catalog(
  #[MapQueryParameter] ?int $min_price = NULL,
  #[MapQueryParameter] ?int $max_price = NULL,
  #[MapQueryParameter] string $sort = 'name_asc',
): JsonResponse {
  // Загрузка и фильтрация товаров…
  $products = $this->loadProducts($min_price, $max_price, $sort);

  return new JsonResponse(['products' => $products]);
}

Атрибут берёт имя параметра запроса из имени аргумента метода. Если нужно использовать другое имя — его можно задать явно: #[MapQueryParameter('min_price')]. Приведение типов выполняется через filter_var(), что позволяет безопасно конвертировать строки в int, float и bool.

Сеттер‑инъекция через #[Required] в AutowireTrait¶

AutowireTrait и AutowiredInstanceTrait получили поддержку сеттер‑инъекции с помощью атрибута #[Required].¹⁹ Теперь не нужно переопределять конструкторы в подклассах плагинов и контроллеров.

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

use Drupal\Core\Plugin\ContainerFactoryPluginInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;

class ExamplePlugin extends PluginBase implements ContainerFactoryPluginInterface {

  public function __construct(
    array $configuration,
    $plugin_id,
    $plugin_definition,
    private readonly Service1Interface $service1,
    private readonly Service2Interface $service2,
  ) {
    parent::__construct($configuration, $plugin_id, $plugin_definition);
  }

  public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition): self {
    return new self(
      $configuration, $plugin_id, $plugin_definition,
      $container->get(Service1Interface::class),
      $container->get(Service2Interface::class),
    );
  }

}

С каждой новой зависимостью конструктор и ::create() растут синхронно. Сеттер‑инъекция помогает решить эту проблему:

use Drupal\Core\DependencyInjection\AutowireTrait;
use Symfony\Contracts\Service\Attribute\Required;

class ExamplePlugin extends PluginBase {

  use AutowireTrait;

  protected Service1Interface $service1;
  protected Service2Interface $service2;

  #[Required]
  public function setService1(Service1Interface $service1): void {
    $this->service1 = $service1;
  }

  #[Required]
  public function setService2(Service2Interface $service2): void {
    $this->service2 = $service2;
  }

}

Зависимости в сеттер‑методах разрешаются так же, как в конструкторе — по типу параметра или с помощью атрибута #[Autowire]. В одном классе можно использовать несколько #[Required]‑методов. Методы обязательно должны быть public — трейт обходит только публичные методы.

Ещё одно преимущество такого подхода, особенно в контексте плагинов, — изменения конструктора родительского класса не потребуют рефакторинга вашего кода.

Кроме того, стоит напомнить: конструкторы сервисов, контроллеров (которые тоже лучше регистрировать как сервисы²⁰) и плагинов — это внутренний API, их не должны переопределять подклассы.²¹

Атрибут #[Bundle] для регистрации бандл-классов сущностей¶

Бандл-класс — это PHP-класс, назначенный конкретному бандлу сущности. Он позволяет добавлять специфичные для бандла методы и свойства прямо в классе, а не рассыпать логику по хукам и сервисам.

Появился PHP-атрибут #[Bundle], который позволяет связать бандл-класс с бандлом прямо в коде.²² Для типов сущностей с bundle_entity_type (node, media и другие) атрибут назначает PHP-класс уже существующему бандлу — вместо hook_entity_bundle_info_alter(). Раньше для этого требовался хук:

#[Hook('entity_bundle_info_alter')]
public function entityBundleInfoAlter(array &$bundles): void {
  $bundles['node']['article']['class'] = Article::class;
}

Теперь достаточно добавить атрибут #[Bundle] непосредственно к классу:

use Drupal\Core\Entity\Attribute\Bundle;
use Drupal\node\Entity\Node;

#[Bundle(
  entityType: 'node',
  bundle: 'article',
)]
class Article extends Node {}

Для типов сущностей без bundle_entity_type атрибут также позволяет объявить сам бандл — достаточно указать параметр label. Это заменяет hook_entity_bundle_info(): определение бандла и его класс оказываются в одном файле:

use Drupal\Core\Entity\Attribute\Bundle;
use Drupal\Core\StringTranslation\TranslatableMarkup;
use Drupal\my_module\Entity\MyEntity;

#[Bundle(
  entityType: 'my_entity',
  bundle: 'foo',
  label: new TranslatableMarkup('Foo'),
)]
class Foo extends MyEntity {}

Для автоматического обнаружения класс должен находиться в пространстве имён \Entity модуля и иметь атрибут #[Bundle].

Маршруты через PHP-атрибуты¶

Добавлена поддержка определения маршрутов прямо в классах контроллеров с помощью PHP-атрибута #[Route].²³ Это стандартный подход из Symfony, и больше не нужно дублировать информацию между YAML-файлом и PHP-кодом.

Drupal автоматически обнаруживает классы в пространстве имён Controller каждого модуля (например, Drupal\example\Controller) и регистрирует маршруты из их атрибутов. YAML-маршрутизация (*.routing.yml) продолжает работать — атрибутный подход дополняет существующую систему.

Рассмотрим пример. Раньше маршрут описывался в YAML-файле:

example.hello:
  path: '/example/hello'
  defaults:
    _controller: '\Drupal\example\Controller\ExampleController::hello'
    _title: 'Hello'
  requirements:
    _permission: 'access content'

Теперь тот же маршрут можно задать атрибутом непосредственно на методе контроллера, а YAML-файл — удалить:

namespace Drupal\example\Controller;

use Drupal\Core\Controller\ControllerBase;
use Symfony\Component\Routing\Attribute\Route;

class ExampleController extends ControllerBase {

  #[Route(
    path: '/example/hello',
    name: 'example.hello',
    requirements: ['_permission' => 'access content'],
    defaults: ['_title' => 'Hello'],
  )]
  public function hello(): array {
    return ['#markup' => $this->t('Hello, World!')];
  }

}

Атрибут можно разместить и на уровне класса — он задаёт общий префикс имени и параметры, которые наследуют все методы. Это удобно, когда контроллер содержит несколько маршрутов с общими настройками:

namespace Drupal\example\Controller;

use Drupal\Core\Controller\ControllerBase;
use Symfony\Component\Routing\Attribute\Route;

#[Route(
  name: 'example.',
  requirements: ['_permission' => 'access content'],
)]
class ExampleController extends ControllerBase {

  #[Route(path: '/example/hello', name: 'hello', defaults: ['_title' => 'Hello'])]
  public function hello(): array {
    return ['#markup' => $this->t('Hello, World!')];
  }

  #[Route(path: '/example/goodbye', name: 'goodbye', defaults: ['_title' => 'Goodbye'])]
  public function goodbye(): array {
    return ['#markup' => $this->t('Goodbye, World!')];
  }

}

В листинге 12 атрибут класса задаёт префикс example. и общее требование _permission для обоих методов. Каждый метод дополняет их своим путём и суффиксом имени — в итоге регистрируются маршруты example.hello и example.goodbye.

Если контроллер реализует единственное действие, можно использовать метод __invoke(). Атрибут на классе задаёт общие настройки, атрибут на методе — суффикс имени маршрута. _controller устанавливается автоматически как имя класса, без ::__invoke:

namespace Drupal\example\Controller;

use Drupal\Core\Controller\ControllerBase;
use Symfony\Component\Routing\Attribute\Route;

#[Route(
  path: '/example/hello',
  name: 'example.',
  requirements: ['_permission' => 'access content'],
  defaults: ['_title' => 'Hello'],
)]
class HelloController extends ControllerBase {

  #[Route(name: 'hello')]
  public function __invoke(): array {
    return ['#markup' => $this->t('Hello, World!')];
  }

}

#[Route(
  path: '/example/hello',
  name: 'example.hello',
  requirements: ['_permission' => 'access content'],
  defaults: ['_title' => 'Hello'],
)]
class HelloController extends ControllerBase {

  public function __invoke(): array {
    return ['#markup' => $this->t('Hello, World!')];
  }

}

Поддержка предзагрузки шрифтов в библиотеках¶

В библиотеках (.libraries.yml) добавлена поддержка ключа fonts для предзагрузки шрифтов.²⁵ Ранее для этого требовалось вручную добавлять ссылки в шаблоны или использовать хуки, теперь же шрифты можно объявлять наравне с CSS и JavaScript.

global-styling:
  version: VERSION
  css:
    theme:
      css/global.css: {}
  fonts:
    fonts/metropolis/Metropolis-Regular.woff2:
      preload: true

Для каждого шрифта с preload: true Drupal добавляет в <head> страницы <link>-тег со всеми необходимыми атрибутами:

<link href="/themes/custom/mytheme/fonts/metropolis/Metropolis-Regular.woff2"
      rel="preload" as="font" type="font/woff2" crossorigin="anonymous" />

type определяется автоматически по расширению файла. crossorigin="anonymous" добавляется всегда — без него браузер выполнит два отдельных запроса на один и тот же шрифт: один для preload, второй — при применении CSS-правила @font-face.

Аналогичная поддержка ключа fonts добавлена в libraryOverrides внутри определений SDC-компонентов (*.component.yml).²⁶

libraryOverrides:
  fonts:
    component-font.woff2:
      preload: true

Поддержка сжатия Brotli для агрегированных ассетов¶

Drupal получил поддержку сжатия Brotli для агрегированных CSS- и JS-файлов.²⁷ Brotli сжимает на 15–25 % лучше, чем gzip — меньше данных, быстрее загрузка в поддерживающих его браузерах.

Теперь при включении сжатия агрегатор генерирует сразу оба формата — .gz (gzip) и .br (Brotli). Сервер отдаёт браузеру наиболее подходящий вариант, при отсутствии поддержки — возвращаясь к gzip.

Требования к серверу:

• Расширение PHP ext-brotli должно быть установлено для генерации .br-файлов.
• Для Apache достаточно обновлённого файла .htaccess — специальные модули не требуются, так как файлы предварительно сжаты.
• Для Nginx необходим модуль ngx_brotli и ручная настройка location-блоков.

В конфигурации system.performance ключи css.gzip и js.gzip объявлены устаревшими. Вместо них введены единые boolean-значения:

• css.compress;
• js.compress.

При обновлении сайта пост-апдейт хук system_post_update_migrate_compress_setting() автоматически мигрирует существующие значения: если gzip был включён — сжатие останется включённым, если отключён — отключится.

Если ваш модуль или профиль программно управляет сжатием ассетов, обновите код:

$config->set('css.gzip', TRUE);
$config->set('js.gzip', TRUE);

$config->set('css.compress', TRUE);
$config->set('js.compress', TRUE);

Для Nginx добавьте в конфигурацию сервера location-блоки с директивой brotli_static:

location ~ ^/sites/.*/files/css/(.*)\.css$ {
    gzip_static on;
    brotli_static on;
    try_files $uri.br $uri.gz $uri =404;
}

location ~ ^/sites/.*/files/js/(.*)\.js$ {
    gzip_static on;
    brotli_static on;
    try_files $uri.br $uri.gz $uri =404;
}

Новый CLI dr с поддержкой команд из модулей¶

В ядро добавлен новый инструмент командной строки vendor/bin/dr — полноценная замена скрипту core/scripts/drupal, который поддерживал только встроенные команды ядра.²⁸

Главное отличие: теперь модули и темы могут регистрировать собственные консольные команды, и dr обнаружит их автоматически. Чтобы команда была обнаружена, её класс должен находиться в пространстве имён Command: src/Command/ внутри модуля или темы. Команды реализуются как классы Symfony Console с атрибутом #[AsCommand], а зависимости разрешаются через автосвязывание.

Если размещение в src/Command/ неудобно, зарегистрируйте команду в контейнере сервисов с меткой console.command — она станет доступна наравне с остальными.

Минимальный пример — команда, которая читает название сайта через ConfigFactoryInterface и выводит приветствие:

<?php

declare(strict_types=1);

namespace Drupal\my_module\Command;

use Drupal\Core\Config\ConfigFactoryInterface;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;

#[AsCommand(
  name: 'example:hello',
  description: 'Greets the site by its name.',
)]
final class HelloCommand extends Command {

  public function __construct(
    private readonly ConfigFactoryInterface $configFactory,
  ) {
    parent::__construct();
  }

  protected function execute(InputInterface $input, OutputInterface $output): int {
    $io = new SymfonyStyle($input, $output);
    $site_name = $this->configFactory->get('system.site')->get('name');
    $io->success("Hello from $site_name!");

    return Command::SUCCESS;
  }

}

Для более сложных сценариев доступен весь арсенал SymfonyStyle: прогресс-бары, таблицы, интерактивные вопросы и цветной вывод.

<?php

declare(strict_types=1);

namespace Drupal\my_module\Command;

use Drupal\Core\Entity\EntityTypeManagerInterface;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;

#[AsCommand(
  name: 'example:progress',
  description: 'Lists all content types with a progress bar.',
)]
final class ProgressCommand extends Command {

  public function __construct(
    private readonly EntityTypeManagerInterface $entityTypeManager,
  ) {
    parent::__construct();
  }

  protected function execute(InputInterface $input, OutputInterface $output): int {
    $io = new SymfonyStyle($input, $output);

    $types = $this->entityTypeManager->getStorage('node_type')->loadMultiple();
    if (!$types) {
      $io->warning('No content types found.');
      return Command::SUCCESS;
    }

    $io->progressStart(count($types));

    $rows = [];
    foreach ($types as $type) {
      $rows[] = [$type->id(), $type->label()];
      $io->progressAdvance();
    }

    $io->progressFinish();
    $io->table(['Machine name', 'Label'], $rows);

    return Command::SUCCESS;
  }

}

Разобравшись, как регистрируются собственные команды, посмотрим на встроенный набор, доступный в ядре на момент релиза:

• completion — генерирует скрипт автодополнения команд для bash, zsh или fish;
• generate-theme — создаёт новую тему на основе стандартных шаблонов ядра;
• help — справка по команде;
• install — установка Drupal через профиль или рецепт;
• list — список всех команд;
• quick-start — установка сайта и запуск локального веб-сервера;
• server — запуск встроенного веб-сервера;
• cache:rebuild (псевдонимы: cr, rebuild) — сброс всех кешей;
• content:export — экспорт контентных сущностей в формат YAML;
• recipe:apply (псевдоним: recipe) — применение рецепта к сайту;
• recipe:info — информация о рецепте;
• system:cron (псевдонимы: cron, core:cron) — запуск cron;
• system:status (псевдоним: status) — статус системы.

Обратите внимание: сейчас отсутствуют команды для экспорта и импорта конфигураций, а также для запуска hook_update_N() и hook_post_update_NAME(). Вероятно, они появятся в будущих релизах или через сторонние модули. Пока dr — не замена Drush, но в перспективе должен ею стать.

Производительность 11.3 vs 11.4¶

Теперь сравним производительность Drupal 11.3.12 и 11.4.0-rc2. Вот условия теста:

• Установочный профиль: Demo Umami — он уже наполнен контентом и имеет готовую вёрстку. Это не просто сайт-пустышка, а вполне себе неплохой референс для тестов.
• Тестируемые страницы (одинаковы для всех сценариев):
  • / — главная
  • /articles — список статей
  • /articles/give-your-oatmeal-the-ultimate-makeover — страница статьи
  • /recipes — список рецептов
  • /recipes/deep-mediterranean-quiche — страница рецепта
• Нагрузочный тест: siege 4.1.7, siege -c5 -r100 --no-parser [URL] — 5 потоков по 100 запросов каждый. Перед запуском делается 5 запросов на прогрев каждой из страниц. Сценарии:
  • dev_mode — режим разработки: drush theme:dev on отключает все кеши и включает отладку Twig шаблонов и тем-хуков.
  • no_cache — page_cache и dynamic_page_cache отключены.
  • dynamic_cache — включён только dynamic_page_cache.
  • full_cache — включены page_cache и dynamic_page_cache.
• Холодный старт — первый запрос сразу после полной очистки кеша (drush cr). 5 повторений (каждое после очистки) на каждую страницу.
• Окружение: Docker-контейнеры на локальной машине.
  • База данных: MariaDB 11.8.8
  • Веб-сервер: Nginx 1.31.2
  • PHP: 8.5.7 с OPcache

Эти тесты не про абсолютную производительность Drupal — нас интересует только то, как изменились цифры между версиями на одном железе с идентичным окружением, чтобы видеть прогресс.

• dev_mode — 24,35 → 27,16 req/s (+11,53%)
• no_cache — 106,91 → 111,87 req/s (+4,63%)
• dynamic_cache — 152,61 → 149,72 req/s (−1,90%)
• full_cache — 300,92 → 301,68 req/s (+0,25%)

По нагрузочному тестированию ярко выражено улучшение в сценариях dev_mode и no_cache, что вполне ожидаемо: основная масса улучшений производительности была направлена именно на то, как и что загружает Drupal, если данных ещё нет в кеше. Остальные показатели, я бы сказал, на уровне погрешности — хоть dynamic_cache и просел на -1,90%, я бы, наверное, отнёс это к шуму измерений, так как никаких явных изменений в этом направлении в 11.4 не припоминаю.

• / — 592 → 582 мс (−1,78%)
• /recipes — 612 → 580 мс (−5,11%)
• /recipes/deep-mediterranean-quiche — 550 → 576 мс (+4,63%)
• /articles — 555 → 540 мс (−2,64%)
• /articles/give-your-oatmeal-the-ultimate-makeover — 539 → 507 мс (−5,84%)
• Среднее: -2,15%

Для холодного старта результаты в целом ожидаемы: стабильное снижение времени первого запроса в среднем на 2–3%. Исключение — /recipes/deep-mediterranean-quiche, где 11.4.0-rc2 показал незначительную деградацию (+4,63%), но откуда она — непонятно: в остальных сценариях страница показывает стабильные улучшения.

В общем, что 11.4 стал чуточку быстрее, чем 11.3, особенно в сценариях, когда кеш ещё недоступен. Это приятно — сайты будут оживать быстрее после деплоя. Но не стоит ожидать прорыва — достойное минорное улучшение для минорного релиза, не более.

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

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

• Объявлен устаревшим метод Drupal\Core\Theme\Registry::getBaseHook(), который не имеет замены из-за отсутствия реальных случаев использования.²⁹
• Объявлены устаревшими константа (\Drupal\Core\Field\Plugin\Field\FieldFormatter\EntityReferenceEntityFormatter::RECURSIVE_RENDER_LIMIT) и свойство ($recursiveRenderDepth), ограничивающие рекурсивный рендеринг, поскольку введён новый механизм защиты от бесконечных циклов на основе отслеживания состояния рендеринга.³⁰
• Добавлен новый метод ::getSummary() в интерфейс FieldTypeCategoryInterface, позволяющий отображать развёрнутые описания категорий полей в административном интерфейсе.³¹
• AJAX page state теперь передаётся как атрибут запроса вместо query-параметра, что требует обновления кода для его получения.³²
• Добавлены параметры $page_top и $page_bottom к методу HtmlRenderer::buildPageTopAndBottom() для управления соответствующими переменными страницы.³³
• Добавлена возможность встраивать содержимое в верхнюю и нижнюю часть страницы через атрибут #attached в контроллере, как альтернатива хукам.³⁴
• Объявлены устаревшими все функции в файле locale.translations.inc. Их функциональность перенесена в новые сервисы.³⁵
• Объявлены устаревшими функции работы с файлами локализации из locale.bulk.inc и locale.batch.inc. Их функциональность перенесена в VO LocaleFile и сервис LocaleFileManager.³⁶
• Объявлены устаревшими все функции в файле locale.fetch.inc. Их функциональность перенесена в сервис LocaleFetch.³⁷
• Добавлен метод EntityTypeInterface::hasIntegerId(), который определяет, является ли ID сущности целочисленным. Объявлены устаревшими DefaultHtmlRouteProvider::getEntityTypeIdKeyType(), CommentTypeForm::entityTypeSupportsComments() и _comment_entity_uses_integer_id().³⁸
• Реализации методов ::getSortedDefinitions() и ::getGroupedDefinitions() интерфейса CategorizingPluginManagerInterface теперь требуют аргумент $label_key.³⁹
• Реализации метода ExecutableInterface::execute() теперь требуют аргумент $object.⁴⁰
• Метод ConfigManager::findConfigEntityDependenciesAsEntities() теперь возвращает конфигурационные сущности без применения переопределений (overrides), используя ::loadMultipleOverrideFree() вместо ::loadMultiple().⁴¹
• Добавлен метод SelectInterface::getRange(), позволяющий получить текущие параметры диапазона (start и length) из объекта Select-запроса.⁴²
• Изменён порядок поиска временной директории в FileSystem::getOsTemporaryDirectory(): результат sys_get_temp_dir() теперь проверяется раньше /tmp, что может изменить расположение временных файлов.⁴³
• Метод ::hasRole() перенесён из UserInterface в AccountInterface, что делает его доступным на уровне базового интерфейса сессий.⁴⁴
• Outbound path processor теперь получают route_name и route_parameters в массиве $options.⁴⁵
• Плагины хранилищ секций Layout Builder теперь должны реализовывать интерфейс SupportAwareSectionStorageInterface.⁴⁶
• FormBase теперь включает AutowireTrait, предоставляя автоматический метод ::create() с разрешением зависимостей по типам. Это позволяет убрать шаблонный ::create() из форм.⁴⁷²⁰
• Метод Url::createFromRequest() теперь автоматически сохраняет query-параметры из запроса, что устраняет необходимость в ручном вызове ::setOption('query', ...).⁴⁸
• AutowireTrait и AutowiredInstanceTrait теперь поддерживают передачу параметров контейнера в конструкторы классов, реализующих ContainerInjectionInterface и ContainerFactoryPluginInterface.⁴⁹²⁰
• Добавлен сервис \Drupal\Core\Field\FieldPurger для очистки данных полей. Функции field_purge_batch(), field_purge_field() и field_purge_field_storage() объявлены устаревшими.⁵⁰
• Метод ::setMultiple() хранилища ключ-значение на базе БД теперь выполняется в транзакции, что гарантирует атомарность операции — все значения сохраняются либо целиком, либо не сохраняются вовсе.⁵¹
• В интерфейс KeyValueStoreInterface добавлен метод ::getAllKeys(), позволяющий получить все ключи коллекции без загрузки самих значений, что снижает потребление памяти при работе с большими коллекциями.⁵²
• Добавлен пакет symfony/polyfill-php86, который делает доступными возможности PHP 8.6 — функцию clamp(), константу ARRAY_FILTER_USE_VALUE и перечисляемый тип SortDirection — при работе на более ранних версиях PHP.⁵³
• В метод ExtensionList::getList() добавлен необязательный аргумент $skip_cache = FALSE. При передаче TRUE обходится как постоянный, так и статический кеш, и список расширений пересчитывается из файловой системы без обновления кеша. Это замена паттерна ->reset()->getList(), который инвалидировал cache_bootstrap на каждом admin-запросе.⁵⁴

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

• Поля сущностей, у которых разрешён только один элемент значения (лимит = 1), теперь загружаются из базы данных одним запросом — раньше для каждого такого поля выполнялся отдельный запрос.⁵⁵
• Теперь загрузка полей с множественным значением стала эффективнее: вместо отдельных запросов для каждого поля формируется один SQL‑запрос.⁵⁶
• Улучшена производительность сортировки ленивой коллекции плагинов за счёт исключения ненужного создания экземпляров плагинов.⁵⁷
• Оптимизированы операции записи в БД при изменении статуса ревизий контента.⁵⁸
• Улучшена производительность перестроения меню за счёт сокращения количества запросов к базе данных: добавлена предзагрузка всех существующих ссылок одним запросом вместо индивидуальных SELECT-запросов для каждой ссылки.⁵⁹
• Добавлена новая настройка ($settings['asset_gc_threshold']) — она позволяет управлять сроком хранения агрегированных файлов ассетов.⁶⁰ По умолчанию этот срок составляет 45 дней.
• Добавлен статический кеш для определений хранилищ полей (field definitions).⁶¹ Это позволяет сократить количество обращений к кеш‑бэкенду и повысить производительность.
• Добавлено статическое кеширование для конфигурационных сущностей стилей изображений, что уменьшает количество запросов к кешу и базе данных.⁶²
• Улучшено кеширование определений полей для типов сущностей: теперь определения для всех бандлов одного типа сущности кешируются одной операцией, что уменьшает количество обращений к кеш-бэкенду.⁶³
• JSON:API больше не проверяет каждый ответ на соответствие схеме по умолчанию. Валидация перенесена в тестовый модуль jsonapi_response_validator, что повышает производительность.⁶⁴
• Нормализация JSON:API теперь пропускает кеширование для ResourceObject с max-age: 0, что позволяет избежать накладных расходов на запись и чтение кеша при обработке больших коллекций сущностей.⁶⁵
• Метаданные кеширования вычисляемых полей (computed) теперь корректно передаются в ответы JSON:API, если класс списка элементов поля реализует CacheableDependencyInterface.⁶⁶
• Оптимизировано количество вызовов FieldDefinition::getColumns() при загрузке сущностей: результаты теперь кешируются в локальные массивы перед обработкой записей из базы данных.⁶⁷
• Оптимизирован метод CacheTagsChecksumTrait::calculateChecksum(): замена array_diff() и array_keys() на цикл с isset() сокращает количество вызовов при загрузке большого числа сущностей с холодным кешем.⁶⁸
• Из сборщика кеша активного пути меню (ActiveTrailCacheCollector) убрана блокировка при записи, что снижает накладные расходы при параллельных запросах.⁶⁹
• Исправлено значение заголовка X-Drupal-Dynamic-Cache для 4xx и 5xx ответов: вместо вводящего в заблуждение UNCACHEABLE (poor cacheability) теперь возвращается UNCACHEABLE (XXX), где XXX — фактический HTTP-статус (например, UNCACHEABLE (403) или UNCACHEABLE (404, sub-request: HIT)).⁷⁰
• Улучшена производительность проверки доступа к теме (ThemeAccessCheck). Теперь используется список тем из контейнера вместо загрузки всех данных темы, что сокращает количество обращений к кешу.⁷¹
• Ответы 404 теперь кешируемые: Router::matchRequest() выбрасывает CacheableResourceNotFoundException вместо ResourceNotFoundException, что позволяет кешировать 404-ответы с корректными метаданными.⁷²
• Добавлено статическое кеширование результата EntityDataDefinition::getDataType(), что сокращает количество вызовов при пакетной обработке сущностей.⁷³
• Оптимизировано кеширование прототипов в TypedDataManager: ссылка на родительский объект больше не включается в прототип — она присваивается при использовании, что устраняет утечки памяти и повышает эффективность LRU-кеша сущностей.⁷⁴
• Удалена ненужная очистка CSS-кеша при установке тем, поскольку кеш CSS не зависит от темы.⁷⁵
• MainContentViewSubscriber переведён на использование #[AutowireLocator], что позволяет инстанцировать только нужный рендерер контента вместо загрузки всех доступных.⁷⁶
• Метод EntityRepository::loadEntityByUuid() теперь использует статический кеш для хранения пар UUID–ID в памяти, что позволяет избежать повторных SQL-запросов при многократных обращениях к одной и той же сущности в рамках одного запроса.⁷⁷
• Свойство EntityBase::$typedData теперь хранится как WeakReference, что устраняет циклическую ссылку и снижает потребление памяти (~3 КБ на сущность).⁷⁸
• Добавлен новый кеш-контекст exception_status_code для условия видимости блоков на страницах с HTTP-исключениями (403, 404). Ранее использовался url.path, что приводило к низкому hit rate кеша блоков — теперь кеш варьируется только по коду статуса, а не по полному URL.⁷⁹
• Устранено избыточное сканирование файловой системы для локальных po-файлов в модуле locale.⁸⁰
• Устранена загрузка форматов дат из конфигурации при получении информации об элементах (element info), что сокращает два лишних обращения к конфигурационным сущностям и кешу на каждый запрос с холодным кешем.⁸¹
• Добавлен новый кеш-бин cache.file_parsing для постоянного кеширования результатов разбора файлов. В отличие от стандартных бинов, он не имеет тега cache.bin и не очищается при drush cr или drupal_flush_all_caches(), что сохраняет кеш между деплоями. Добавлен базовый класс FileParsingCacheCollectorBase с валидацией по mtime; новый YamlCacheCollector уже использует этот бин для разбора libraries.yml и routing.yaml.⁸²
• Удалён класс RoutePreloader, который при каждом HTML-запросе загружал все публичные маршруты и потреблял значительный объём памяти. Кеш маршрутов переведён на выделенный bin routes с поддержкой APCu через fast-chained механизм.⁸³

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

• Объявлены устаревшими модули Migrate Drupal (инструменты миграции с Drupal 6 и 7)⁸⁴, History⁸⁵ и Contact⁸⁶.
• Плагин поиска node_search перемещён из модуля node в новый подмодуль search_node модуля search. Классы, расширяющие NodeSearch, необходимо обновить для расширения \Drupal\search_node\Plugin\Search\SearchNode.⁸⁷
• Объявлены устаревшими batch-функции из файлов locale.batch.inc, locale.bulk.inc и locale.compare.inc. Их функциональность перенесена в методы сервиса LocaleFetch.⁸⁸
• Объявлены устаревшими процедурные функции из locale.compare.inc — locale_translation_flush_projects(), locale_translation_build_projects(), locale_translation_check_projects(), locale_translation_check_projects_local() и другие — а также сервис locale.project и интерфейс LocaleProjectStorageInterface. Их функциональность перенесена в новые сервисы LocaleProjectRepository и LocaleProjectChecker.⁸⁹
• Объявлены устаревшими функции locale_translation_get_file_history(), locale_translation_update_file_history() и locale_translation_file_history_delete(). Их функциональность перенесена в новый сервис CurrentImportStateStorage и value object CurrentImportState.⁹⁰
• Объявлены устаревшими функции статуса переводов локализации: locale_translation_get_status(), locale_translation_status_save(), locale_translation_status_delete_languages(), locale_translation_status_delete_projects() и locale_translation_clear_status(). Вместо них следует использовать сервис LocaleSource с методами ::loadSources() и ::loadSource().⁹¹
• Объявлены устаревшими функции с префиксом _ из editor.module, их функциональность перемещена в методы класса EditorHooks.⁹²
• Объявлены устаревшими функция editor_image_upload_settings_form() и файл editor.admin.inc. Логика перенесена в сервис EditorImageUploadSettings и его метод ::getForm().⁹³
• Объявлена устаревшей функция editor_filter_xss(). Её функциональность перенесена в метод Element::filters().⁹⁴
• Объявлены устаревшими статические методы Views::pluginManager() и Views::handlerManager() в пользу Dependency Injection или Service Locator.⁹⁵
• Файл views_ui/admin.inc объявлен устаревшим. Процедурные функции перенесены в трейты ViewsFormAjaxHelperTrait и ViewsFormHelperTrait.⁹⁶
• Объявлен устаревшим метод CachePluginBase::getRowCacheKeys() и удалено дублирующее кеширование отдельных строк представлений для улучшения производительности.⁹⁷
• Объявлен устаревшим метод CachePluginBase::cacheExpire() модуля Views, поскольку система кеширования уже предотвращает возврат просроченных результатов.⁹⁸
• Объявлены устаревшими функции views_ui_contextual_links_suppress(), views_ui_contextual_links_suppress_push() и views_ui_contextual_links_suppress_pop() без замены, так как их функциональность давно не работала корректно.⁹⁹
• Метод ViewExecutable::getHandler() переименован в ViewExecutable::getHandlerConfiguration() — старое название вводило в заблуждение, так как метод возвращает конфигурацию обработчика, а не его экземпляр. Старый метод объявлен устаревшим и будет удалён в Drupal 13.¹⁰⁰
• Функция comment_preview() объявлена устаревшей — её логика перемещена в метод CommentForm::preview().¹⁰¹
• Константы для настроек обратной связи анонимных пользователей в CommentInterface объявлены устаревшими. Вместо них добавлен перечисляемый тип AnonymousContact.¹⁰²
• Объявлены устаревшими константы CommentItemInterface::FORM_SEPARATE_PAGE и FORM_BELOW. Вместо них следует использовать перечисляемый тип FormLocation со значениями SeparatePage и Below.¹⁰³
• Объявлено устаревшим недокументированное свойство User::$password.¹⁰⁴
• Функции user_cookie_save() и user_cookie_delete() объявлены устаревшими. Вместо них следует использовать методы ::setCookie() и ::clearCookie() объекта Symfony Response.¹⁰⁵
• Функция user_form_process_password_confirm() объявлена устаревшей. Вместо неё следует использовать UserThemeHooks::processPasswordConfirm().¹⁰⁶
• Объявлены устаревшими функции однократной аутентификации пользователей: user_pass_rehash(), user_cancel_url(), user_mail_tokens() и user_pass_reset_url(). Их функциональность перенесена в новый сервис OneTimeAuthentication с методами ::generateHmac(), ::generateCancelConfirmUrl(), ::tokens() и другими.¹⁰⁷
• Функция node_access_grants() объявлена устаревшей. Вместо неё следует использовать сервис NodeGrantsHelper и его метод ::nodeAccessGrants(). Классы NodeAccessGrantsCacheContext и NodeGrantDatabaseStorage теперь требуют NodeGrantsHelper в качестве аргумента конструктора.¹⁰⁸
• Функции node_access_rebuild() и node_access_needs_rebuild() объявлены устаревшими. Вместо них следует использовать сервис NodeAccessRebuild с методами ::rebuild(), ::needsRebuild() и ::setNeedsRebuild().¹⁰⁹
• Объявлен устаревшим класс \Drupal\node\Controller\NodeViewController. Он функционально идентичен EntityViewController, и вместо него следует использовать \Drupal\Core\Entity\Controller\EntityViewController.¹¹⁰
• Объявлена устаревшей библиотека node/form и файл node.module.css, содержавший неиспользуемые стили.¹¹¹
• Объявлено устаревшим использование длинного формата подсказок фильтров текста и страницы для их отображения.¹¹²
• Добавлен новый сервис FilterFormatRepositoryInterface для работы с форматами фильтров. Функции filter_formats(), filter_formats_reset(), filter_get_formats_by_role(), filter_default_format() и filter_fallback_format() объявлены устаревшими.¹¹³
• Функция check_markup() объявлена устаревшей без прямой замены. Вместо неё рекомендуется возвращать рендер-массив с типом #type => 'processed_text', который сохраняет метаданные кеширования.¹¹⁴
• Функция text_summary() объявлена устаревшей. Её функциональность перенесена в сервис TextSummary, метод ::generate() которого принимает те же аргументы.¹¹⁵
• Класс InstallerRouteBuilder удалён без замены — он стал ненужным после введения обнаружения маршрутов через PHP-атрибуты.¹¹⁶
• Module handler и controller resolver исключены из конструктора RouteBuilder: PHP-атрибуты для определения маршрутов устранили необходимость в них.¹¹⁷
• Объявлены устаревшими плагины обработки миграций LinkOptions, LinkUri, Timezone и UserLangcode из модулей menu_link_content, system и user. Их функциональность перенесена в аналогичные классы модуля migrate.¹¹⁸
• Объявлены устаревшими процедурные функции _contextual_links_to_id() и _contextual_id_to_links() и добавлен новый сервис ContextualLinksSerializer для их замены.¹¹⁹
• Объявлены устаревшими конструкторы ограничений (констрейнов) с массивом опций и введена поддержка именованных аргументов для улучшения типобезопасности API.¹²⁰
• Множество процедурных функций отправки форм, валидации и AJAX‑функций обратного вызова объявлены устаревшими.¹²¹
• Объявлено устаревшим использование свойства #item_attributes в тем-хуках image_formatter и responsive_image_formatter.¹²² Теперь следует использовать стандартное свойство #attributes.
• Добавлена настройка для блоков системных меню, позволяющая управлять добавлением CSS-класса текущей страницы.¹²³
• Объявлен устаревшим класс WebDriverCurlService.¹²⁴
• Метод LinkWidget::validateTitleElement() объявлен устаревшим. Валидация перенесена в LinkTitleRequiredConstraintValidator на уровне плагина поля LinkItem.¹²⁵
• Передача NULL в качестве параметра $deserialization_target_class конструктора ResourceType объявлена устаревшей. Вместо этого следует использовать stdClass::class.¹²⁶
• Ключ uri_callback в аннотации типа сущности объявлен устаревшим. Вместо него следует использовать link templates или outbound path processor.¹²⁷
• Удалена функция _update_cron_notify(). Её логика перенесена в UpdateCronHooks, а отправка почты — в сервис MailHandler модуля Update.¹²⁸
• Адреса электронной почты в устаревших форматах (например, с пробелом перед символом @) теперь не проходят валидацию форм. Ранее такие адреса принимались, но почтовые серверы обычно отвергали их при отправке.¹²⁹
• Объявлено устаревшим обращение к глобальной переменной $autoload / $GLOBALS['autoload'] для получения Composer-автозагрузчика. Вместо этого следует явно подключать автозагрузчик через require '/vendor/autoload.php'.¹³⁰
• Объявлены устаревшими функции hide() и show(). Вместо них следует напрямую управлять свойством #printed рендер-массива: $element['#printed'] = TRUE для скрытия и $element['#printed'] = FALSE для отображения.¹³¹
• Объявлены устаревшими все процедурные функции из menu_ui.module. Их функциональность перенесена в сервис MenuUiHelper и методы класса MenuUiHooks.¹³²
• Объявлен устаревшим трейт ToStringTrait. Вместо него метод __toString() следует реализовывать напрямую, а класс — объявлять реализующим интерфейс \Stringable.¹³³
• Объявлены устаревшими аргументы смещения курсора и ориентации в методе StatementInterface::fetch(). Они не тестировались и, вероятно, не работали корректно — в Drupal 12 будут удалены.¹³⁴
• Объявлен устаревшим защищённый метод SqlContentEntityStorage::loadFromSharedTables() без замены. Его логика объединена с ::loadFromDedicatedTables().¹³⁵
• Использование значений, отличных от булевого типа или объекта AccessResultInterface для ключа #access в рендер массивах, объявлено устаревшим.¹³⁶
• Объявлены устаревшими функции dblog_filters и _dblog_get_message_types, а также файл dblog.admin.inc. Вместо них следует использовать сервис DbLogFilters.
• Объявлена устаревшей функция block_theme_initialize(). Логика перенесена в защищённый метод класса BlockHooks без публичной замены.¹³⁷
• Объявлен устаревшим метод SessionManager::delete(). Вместо него следует использовать UserSessionRepository::deleteAll().¹³⁸
• Объявлена устаревшей концепция «доверенных данных» (trusted data) в конфигурации: метод ConfigEntityInterface::trustData() и параметр $has_trusted_data в Config::save(). Теперь валидация схемы конфигурации, приведение типов и сортировка ключей применяются ко всем сохранениям конфигурации автоматически.¹³⁹
• Уточнены типы возвращаемых значений метода ::normalize() в классах нормализаторов сериализации: ComplexDataNormalizer, ConfigEntityNormalizer, ContentEntityNormalizer, EntityReferenceFieldItemNormalizer, ListNormalizer, TimestampItemNormalizer теперь возвращают array, MarkupNormalizer — string, NullNormalizer — null.¹⁴⁰¹⁴¹
• Объявлены устаревшими функции file_get_file_references() и file_field_find_file_reference_column(). Вместо первой следует использовать сервис FileReferenceResolver и его метод ::getReferences(); вторая не имеет замены.¹⁴²
• Объявлен устаревшим параметр $sql_query метода Query::getTables() — объект запроса теперь определяется из самого entity query, и передавать его явно больше не нужно. Кроме того, Query::condition() больше не принимает объект Condition, созданный в контексте другого entity query; в Drupal 13 это будет явно запрещено.¹⁴³
• Объявлена устаревшей валидация CSRF-токенов по ключу 'rest' в CsrfRequestHeaderAccessCheck. Этот запасной ключ сохранялся с Drupal 8 для совместимости с сессиями, созданными до обновления до Drupal 9, — теперь такие сессии не поддерживаются. В Drupal 12 валидация по ключу 'rest' удалена полностью.¹⁴⁴
• Метод RowPluginBase::render() теперь принимает только экземпляры \Drupal\views\ResultRow. Передача любых других аргументов вызывает предупреждение об устаревании — в Drupal 12 метод получит строгую типизацию.¹⁴⁵

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

• Улучшена валидация ссылок в виджете LinkWidget: теперь сообщения об ошибках адаптированы под тип ссылки, делая их более понятными для пользователей.¹⁴⁶
• Виджеты и форматеры поля основного текста в стандартном профиле и рецептах изменены: теперь используется text_long вместо text_with_summary.¹⁴⁷
• При ручном создании учётной записи уведомление по электронной почте с инструкциями по установке пароля теперь включено по умолчанию.¹⁴⁸
• Форма настройки информации о сайте теперь сохраняет пути к главной странице, 403 и 404 страницам в том виде, в котором их ввёл пользователь, включая неразрешённые псевдонимы, а не преобразует их во внутренние пути.¹⁴⁹
• Добавлена поддержка полноэкранного режима редактирования в CKEditor 5.¹⁵⁰
• Виджет поля Link теперь поддерживает формат route:{$route_name}, сохраняя префикс route: при повторном сохранении содержимого.¹⁵¹
• Из модуля Navigation удалены жёстко заданные ссылки на создание пользователей, а также медиа-сущностей «Изображение» и «Документ» из меню «Содержимое». При необходимости ссылки можно добавить обратно вручную через /admin/structure/menu/manage/content.¹⁵²
• Модуль Navigation добавлен в стандартный профиль установки и рецепт, заменяя Toolbar в качестве навигации по умолчанию.¹⁵³
• При удалении темы через интерфейс теперь отображается страница подтверждения с перечнем конфигураций, которые будут удалены или изменены. Это позволяет отменить удаление до применения изменений.¹⁵⁴
• Форматтер строковых полей теперь поддерживает ссылку не только на страницу просмотра сущности (canonical), но и на форму её редактирования. Тип ссылки выбирается в настройках форматтера.¹⁵⁵
• HTML5-валидация форм отключена по умолчанию из-за проблем с доступностью. Добавлена настройка enable_html5_validation в settings.php для управления поведением, а также предупреждение на странице отчёта о состоянии.¹⁵⁶
• Отключённые ссылки меню теперь игнорируются при построении активного пути (active trail), что устраняет некорректное назначение CSS-класса «active» родительским элементам меню.¹⁵⁷
• Вкладка «Управление отображением» теперь ведёт на новую обзорную страницу режимов отображения /admin/structure/types/manage/{bundle}/display вместо формы редактирования режима по умолчанию. Страница отображает все режимы отображения бандла со статусом и позволяет включать или отключать их напрямую.¹⁵⁸

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

• Вместо собственных CSS-правил Views (views-align-*) для выравнивания содержимого столбцов таблиц теперь используются классы из модуля system (align-left, align-center, align-right), обеспечивающие идентичное поведение.¹⁵⁹
• Обновлены стандартные иконки типов файлов: созданы новые высококачественные SVG-файлы, заменяющие устаревшие растровые PNG для улучшенного отображения на экранах с высоким разрешением.¹⁶⁰
• Удалены избыточные WAI-ARIA role-атрибуты из шаблонов, дублирующие семантику современных HTML5-элементов, для улучшения соответствия стандартам.¹⁶¹
• Добавлена поддержка Twig-функции html_cva() из пакета twig/html-extra для реализации паттерна Class Variance Authority (CVA), упрощающего условное управление CSS-классами в шаблонах. Помимо html_cva(), стали доступны функции html_attr() и html_classes().¹⁶²
• Из темы Default Admin удалены шаблоны для модулей Book и Forum, ранее вынесенных из ядра.¹⁶³
• Ссылки, создаваемые Twig-функциями help_route_link() и help_topic_link(), больше не формируются абсолютными по умолчанию. Для получения абсолютных URL следует явно передать $options['absolute'] = TRUE.¹⁶⁴
• Добавлен объект расширения темы с методами ::listAllRegions(), ::listVisibleRegions() и ::getDefaultRegion() для работы с регионами темы. Объявлены устаревшими функции system_region_list() и system_default_region(), а также константы REGIONS_VISIBLE и REGIONS_ALL.¹⁶⁵
• SDC-компоненты теперь можно использовать как элементы форм. ComponentElement реализует FormElementInterface и зарегистрирован как #[FormElement('component')], что позволяет использовать #type: component с поддержкой валидации и значений по умолчанию (но без #ajax, #process и других PHP-only свойств).¹⁶⁶
• Для слотов SDC-компонентов добавлена возможность объявлять ожидаемые дочерние компоненты (expected — по ID или тегу) и ограничивать их количество (minItems, maxItems) в *.component.yml.¹⁶⁷
• Тем-хук navigation__message удалён — компонент сообщений модуля Navigation переведён на SDC.¹⁶⁸
• Изменено поведение атрибутов блока: ключ #attributes в рендер-массиве содержимого блока теперь применяется к обёртке содержимого (.content), а не к внешней обёртке блока. Для применения атрибутов ко всему блоку следует использовать #wrapper_attributes.¹⁶⁹
• Свойство #url в тем-элементе responsive_image_formatter теперь является объектом Url вместо строки. В Twig-шаблоне responsive-image-formatter.html.twig для получения строки URL следует использовать url.toString().¹⁷⁰

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

• Добавлена поддержка автосвязывания (autowiring) для плагинов ImageToolkit и ImageToolkitOperation.¹⁷¹

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

• Удалён модуль history из стандартного профиля установки и рецепта, подготовка к его переносу в сторонний модуль.¹⁷²
• Модуль Shortcut удалён из стандартного профиля установки и рецепта, в рамках подготовки к переносу в контрибутный модуль.¹⁷³
• Типы контента «Статья» и «Страница» больше не устанавливаются при использовании стандартного профиля установки или рецепта. Новые сайты должны самостоятельно настраивать необходимые типы контента.¹⁷⁴
• Шаблон проекта drupal/legacy-project объявлен заброшенным (abandoned). Рекомендуется использовать drupal/recommended-project.¹⁷⁵
• Метапакет drupal/core-dev-pinned объявлен устаревшим. Вместо него рекомендуется использовать drupal/core-dev.¹⁷⁶
• Добавлена новая конфигурационная операция (core.menu.static_menu_link_overrides:overrideMenuLinks).¹⁷⁷ Она позволяет переопределять статические ссылки меню — например, изменять их свойства (вес и состояние) с помощью рецептов.
• Модуль Locale теперь использует хеш файла (xxh128) вместо времени модификации (filemtime()) для обнаружения изменений в локальных файлах переводов, что повышает надёжность в современных средах развёртывания (например, Docker, где COPY не сохраняет временные метки файлов).¹⁷⁸
• Значение version в файлах .info.yml теперь должно быть строкой. Числовые значения вроде 1.0 приводили к проблемам парсинга (например, 1.0 упрощалось до 1).¹⁷⁹
• Библиотека justinrainbow/json-schema теперь считается полноценной зависимостью, а не только зависимостью для разработки.¹⁸⁰
• В стандартный robots.txt добавлены правила блокировки индексации страниц поиска с query-параметрами (/search?, /index.php/search?), что предотвращает индексацию динамически генерируемых страниц поисковых результатов.¹⁸¹
• Импорт содержимого по умолчанию (default content) теперь поддерживает формат JSON наряду с YAML.¹⁸²
• Drupal перешёл на компонент symfony/runtime для разделения логики начальной загрузки и обработки запросов. Фронт-контроллеры (index.php, update.php) обновлены под новый паттерн с классом DrupalRuntime. При запуске composer update может потребоваться добавить symfony/runtime в секцию allow-plugins файла composer.json.¹⁸³
• Стандартный профиль установки и рецепт standard больше не включают модуль comment. Функционал комментариев теперь необходимо включать явно — сам модуль по-прежнему входит в ядро.¹⁸⁴
• drupal/core-recommended больше не закрепляет минорные версии ряда зависимостей (guzzlehttp/guzzle, guzzlehttp/psr7, twig/twig, symfony/polyfill-* и других). Теперь сайты смогут применять обновления безопасности этих пакетов сразу после релиза, не дожидаясь нового выпуска Drupal Core — это поведение стало необходимым из-за изменений в Composer 2.9.¹⁸⁵

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

• Drupal перешёл на использование W3C-совместимого веб-драйвера для тестирования.¹⁸⁶
• Объявлен устаревшим метод ::expectDeprecation() и трейт ExpectDeprecationTrait. Вместо них следует использовать нативные методы PHPUnit ::expectUserDeprecationMessage() и ::expectUserDeprecationMessageMatches().¹⁸⁷
• Добавлен кастомный ErrorFormatter для PHPStan, позволяющий объединить вывод нескольких форматов (JUnit, GitLab, таблица) в одном запуске вместо многократного выполнения анализа.¹⁸⁸
• Добавлен трейт HttpKernelUiHelperTrait с методом ::drupalGet() для ядерных (kernel) тестов, позволяющий выполнять HTTP-запросы и проверять содержимое ответа с помощью Mink. Это даёт возможность конвертировать многие браузерные тесты в значительно более быстрые kernel-тесты.¹⁸⁹
• Сокращено количество пересборок контейнера при выполнении функциональных тестов, что значительно ускоряет их прохождение.¹⁹⁰
• Публичные методы ::testGet(), ::testPost(), ::testPatch() и ::testDelete() в EntityResourceTestBase переименованы в защищённые ::doTest*() и объединены в один публичный метод ::testCrud().¹⁹¹

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

• Поле UUID теперь валидирует хранимое значение. Ранее проверялась только длина строки, что позволяло сохранять невалидные UUID.¹⁹²
• В поле ссылки добавлено вычисляемое свойство resolvable_uri, содержащее готовый URL с учётом всех URL-опций (query, fragment и др.) — в отличие от uri, которое хранит сырой вид (internal:/, entity:node/5). Свойство доступно в Twig-шаблонах и через JSON:API/REST.¹⁹³

Доступ и безопасность¶

• Добавлена новая операция контроля доступа 'view linked label' для сущности пользователя, определяющая возможность отображения имени как ссылки на профиль.¹⁹⁴
• Объявлена устаревшей конфигурация locale.settings:translation.path. Вместо неё следует использовать настройку $settings['locale_translation_path'] в settings.php.¹⁹⁵
• Добавлена возможность настройки алгоритма и параметров хеширования паролей через параметры ядра password.algorithm и password.options в services.yml.¹⁹⁶
• В трейт HttpKernelUiHelperTrait добавлен метод ::clickLink(), позволяющий имитировать клик по ссылке в kernel-тестах без необходимости использовать браузерные тесты.¹⁹⁷
• Методы AccessResult::allowedIf() и AccessResult::forbiddenIf() теперь принимают необязательный аргумент с причиной нейтрального результата доступа.¹⁹⁸
• Маршруты HTTP-аутентификации user.login.http, user.pass.http, user.login_status.http и user.logout.http перенесены в модуль REST и переименованы (rest.login, rest.pass, rest.login_status, rest.logout). Контроллер UserAuthenticationController заменён на RestAuthenticationController.¹⁹⁹
• Добавлено новое разрешение 'view unpublished block content', позволяющее редакторам просматривать неопубликованные блок-контент-сущности без необходимости иметь разрешения «administer block content» или «access block library».²⁰⁰