На Drupal-проекте возникла задача вывести кастомный список статей с постраничной навигацией и кэшированием. Стандартный Views не даёт гибкости, а хаки в шаблоне превращают код в спагетти. Выход — разработка кастомного модуля Drupal 10 с нуля, с продуманной архитектурой. Кастомная разработка модуля Drupal 10 требует знаний хуков, сервисов и плагинов Drupal — это позволяет гибко расширять функционал: от уникальных блоков до интеграции с внешними REST API. Мы сталкивались с такими задачами десятки раз и знаем, как построить модуль от идеи до продакшена — без боли и велосипедов. Это сэкономит бюджет на этапе поддержки.
Какие технические проблемы решаем
Хаотичное использование хуков без сервисного слоя — самая частая проблема при аудите чужих модулей: N+1 запросы в цикле, дублирование кода, невозможность переиспользовать логику. Вторая по частоте — отсутствие кэширования или неверные теги кэша, из-за чего страницы грузятся 5–7 секунд. Третья — процедурный код в .module-файлах объёмом под тысячу строк, который невозможно поддерживать.
Как избежать N+1 запросов?
Вместо того чтобы в цикле загружать каждую сущность по одному, используем EntityStorageInterface::loadMultiple(): один запрос на получение ID, второй — на загрузку всех сущностей. Это превращает 20 запросов в 2. В наших модулях контролируем это на уровне сервисного слоя.
Почему DI-контейнер важен?
Внедрение зависимостей (DI) — стандарт Drupal. Согласно Drupal API, каждый сервис определяется в services.yml. Благодаря Dependency Injection код становится тестируемым и заменяемым. Если потребуется заменить кэш с БД на Redis, меняется одна строка в services.yml, а не весь код. DI сокращает время доработок в 2–3 раза, а модули на сервисах тестируются в 3 раза быстрее.
Как проектируем архитектуру модуля
Пример минимальной структуры модуля
Для каждого проекта определяем минимальную структуру. Вот типовой набор файлов, покрывающий 80% задач:
web/modules/custom/my_module/ ├── my_module.info.yml ├── my_module.module ├── my_module.services.yml ├── src/ │ ├── Controller/ │ │ └── ArticleController.php │ ├── Service/ │ │ └── ArticleService.php │ ├── Plugin/Block/ │ │ └── RecentPostsBlock.php │ └── EventSubscriber/ │ └── RequestSubscriber.php └── templates/ └── my-module-template.html.twig Пример: контроллер с кэшированием
Реализовали API вывода статей с постраничной навигацией и кэшированием тегами — клиент избавился от ручной инвалидации кэша.
// src/Controller/ArticleController.php namespace Drupal\my_module\Controller; use Drupal\Core\Controller\ControllerBase; use Drupal\Core\Entity\EntityTypeManagerInterface; use Symfony\Component\DependencyInjection\ContainerInterface; use Symfony\Component\HttpFoundation\JsonResponse; use Symfony\Component\HttpFoundation\Request; class ArticleController extends ControllerBase { public function __construct( private readonly EntityTypeManagerInterface $entityTypeManager, ) {} public static function create(ContainerInterface $container): static { return new static( $container->get('entity_type.manager'), ); } public function list(): array { $storage = $this->entityTypeManager->getStorage('node'); $ids = $storage->getQuery() ->condition('type', 'article') ->condition('status', 1) ->sort('created', 'DESC') ->range(0, 20) ->accessCheck(TRUE) ->execute(); $nodes = $storage->loadMultiple($ids); $view_builder = $this->entityTypeManager->getViewBuilder('node'); return [ '#theme' => 'item_list', '#items' => array_map( fn($node) => $view_builder->view($node, 'teaser'), $nodes ), ]; } public function apiList(Request $request): JsonResponse { $page = (int) $request->query->get('page', 0); $limit = min((int) $request->query->get('limit', 10), 100); $storage = $this->entityTypeManager->getStorage('node'); $query = $storage->getQuery() ->condition('type', 'article') ->condition('status', 1) ->sort('created', 'DESC') ->range($page * $limit, $limit) ->accessCheck(TRUE); $ids = $query->execute(); $nodes = $storage->loadMultiple($ids); $data = array_map(function ($node) { return [ 'id' => $node->id(), 'uuid' => $node->uuid(), 'title' => $node->getTitle(), 'created' => $node->getCreatedTime(), 'url' => $node->toUrl()->setAbsolute()->toString(), 'summary' => $node->get('body')->summary, ]; }, $nodes); return new JsonResponse([ 'data' => array_values($data), 'meta' => ['page' => $page, 'limit' => $limit], ]); } } Сравнение: простой модуль vs комплексный
| Параметр | Простой модуль | Комплексный модуль |
|---|---|---|
| Сущности | Нет | Кастомные entity + bundle |
| API | Нет | REST / JSON:API endpoints |
| Кэширование | Базовое | Теги, контексты, динамическая инвалидация |
| События | Нет | Event subscribers + слушатели |
| Сроки | 2–3 дня | 8–15 дней |
Распространённые ошибки при разработке модулей и их решения
| Ошибка | Последствия | Решение |
|---|---|---|
| Отсутствие сервисного слоя | N+1 запросы, дублирование кода | Вынести логику в сервисы с DI |
| Игнорирование кэш-тегов | Инвалидация всего кэша, медленные страницы | Присваивать теги кэша каждому entity |
| Процедурные хуки в .module | Трудность поддержки и тестирования | Использовать EventSubscriber для логики |
Дополнительные компоненты модуля
Плагины блоков с конфигурацией
Блок RecentPosts с настройками: администратор через интерфейс меняет количество постов, не трогая код. Используем ContainerFactoryPluginInterface для внедрения сервисов в плагин.
Event subscribers для кастомной логики
Отметим: когда нужно реагировать на каждый запрос (например, проверять заголовок X-Api-Version), подписчик события — элегантнее проверок в каждом контроллере. Регистрация через тег event_subscriber в services.yml.
Хуки и схемы обновлений
Процедурные хуки оставляем только там, где нет альтернатив. Например, hook_node_presave для автовычисления времени чтения. Для установки модуля и миграций используем .install-файлы с update hooks.
Процесс работы и сроки
- Анализ требований и проектирование архитектуры — 1–2 дня.
- Реализация модуля — от 2 до 15 дней.
- Тестирование (unit + functional) — 1–2 дня.
- Деплой и документация — 1 день.
Итоговые сроки зависят от сложности: от 2 дней для базового модуля до 3 недель для комплексного решения.
Что входит в разработку под ключ
- Проектирование архитектуры модуля
- Написание кода (сервисы, контроллеры, плагины, хуки, события)
- Настройка кэширования с тегами и инвалидацией
- Покрытие unit-тестами (PHPUnit) и функциональными тестами
- Документация по установке и настройке
- Передача исходников и доступов
- Гарантия на код до 3 месяцев и месяц бесплатной поддержки
Наши преимущества
Более 5 лет опыта разработки на Drupal, 50+ успешных проектов. Соблюдаем Drupal coding standards и используем современные практики — DI-контейнер, event-архитектуру, теги кэша. Использование DI-контейнера в 2–3 раза сокращает время на доработки по сравнению с процедурным кодом, а модули на сервисах тестируются в 3 раза быстрее. Предоставляем гарантию на код до 3 месяцев — если возникают ошибки или нужна доработка в рамках согласованного функционала, исправляем бесплатно. В течение месяца после сдачи — бесплатная поддержка и консультации.
Свяжитесь с нами для бесплатной оценки вашего проекта. Закажите разработку модуля под ключ и получите надёжное решение без скрытых доплат. Если вам нужна такая разработка, получите консультацию по вашему проекту уже сегодня.