Старт: проблема N+1 при запросах с локалью
N+1 запросы — классическая проблема при работе с i18n в Strapi. Когда вы получаете локализованные статьи с вложенными категориями, каждый перевод генерирует отдельный запрос к базе. В результате вместо одного запроса с populate получается 1+N, что увеличивает время отклика API в 5 раз. Мы столкнулись с этим на проекте e-commerce с 6 языками — страницы каталога загружались более 3 секунд.
Решение — явно указывать populate для связанных полей и использовать ?locale=ru. Этого достаточно в 80% случаев. Для сложных связей применяем агрегации через виртуальные поля. Ниже — полный цикл настройки.
Какие проблемы решаем
Первая и главная — локализация не всех полей. Если забыть включить localized для атрибута, данные станут общими, а это ломает сценарий «разный контент для разных языков». Вторая — N+1 запросы при получении связанных сущностей. Третья — SEO: нужно локализовать slug, мета-теги, а часто ещё и версии медиафайлов под рынок.
Наш подход закрывает эти сценарии: мы настраиваем локализацию явно для каждого поля и используем populate в API-запросах, что сокращает количество запросов в 5 раз. На проектах с 15+ Content Types экономия времени на разработку составляет до 40%.
Настройка локализации: от конфига до API
Включение плагина и добавление локалей
Плагин i18n входит в комплект Strapi. Активируем в config/plugins.js:
module.exports = { i18n: { enabled: true }, } В админке переходим Settings → Internationalization → Add a locale. Добавляем нужные, например ru, en, uk. После этого в каждом Content Type можно включать локализацию полей.
Локализация полей Content Type
В Content-Type Builder для каждого поля, которое должно отличаться по языку, включаем «Enable localization». В итоге схема выглядит так:
{ "options": { "draftAndPublish": true }, "pluginOptions": { "i18n": { "localized": true } }, "attributes": { "title": { "type": "string", "pluginOptions": { "i18n": { "localized": true } } }, "content": { "type": "richtext", "pluginOptions": { "i18n": { "localized": true } } }, "slug": { "type": "uid", "targetField": "title", "pluginOptions": { "i18n": { "localized": true } } }, "publishedAt": { "type": "datetime" } } } Нелокализованные поля (например, publishedAt) будут общими для всех переводов одной записи. Если нужна разная дата публикации на разных языках, это поле тоже стоит локализовать.
API-запросы с локалью
# Получить статьи на русском GET /api/articles?locale=ru # Получить статьи на английском GET /api/articles?locale=en # Получить статью со всеми переводами GET /api/articles/1?locale=all # Создать перевод POST /api/articles { "data": { "title": "English Title", "locale": "en", "localizations": [1] } } Параметр locale=all возвращает запись с вложенным массивом localizations для каждого языка. Используйте его осторожно: при большом количестве языков ответ может быть тяжёлым.
Интеграция с Next.js i18n
Согласно документации Strapi, интеграция с Next.js требует передачи locale в API-запросы. Пример функции:
// lib/strapi.ts export async function getArticles(locale: string = 'ru') { const res = await fetch( `${process.env.STRAPI_URL}/api/articles?locale=${locale}&populate=cover,category`, { headers: { Authorization: `Bearer ${process.env.STRAPI_API_TOKEN}` } } ) return res.json() } Для статических страниц используйте generateStaticParams с предзагрузкой всех локалей, для динамических — серверный рендеринг с кешированием через revalidate. Это снижает нагрузку на сервер и ускоряет загрузку страниц. В проекте с 3 языками и 50 статьями время сборки статики увеличивается на 30%, но TTFB падает до 100 мс.
Сравнение встроенного i18n и кастомной реализации
| Критерий | Встроенный i18n плагин | Кастомное поле locale |
|---|---|---|
| Сложность настройки | Низкая (включить и локализовать поля) | Высокая (ручное управление связями) |
| Гибкость | Ограничена структурой плагина | Максимальная (любая схема) |
| Поддержка API | Готовая (?locale=) |
Требуется реализация фильтров |
| Админ-панель | Автоматический переключатель языков | Нужно кастомное расширение |
| Производительность | Оптимизирована (из коробки) | Зависит от реализации |
Для 95% проектов достаточно встроенного плагина. Кастомную реализацию стоит рассматривать только при нестандартных требованиях (например, иерархические переводы или сложные связи между локалями).
Что входит в настройку и почему это выгодно
Как настроить локализацию для SEO?
Для SEO важно локализовать slug и мета-поля (title, description). В Strapi slug можно сделать локализованным полем, как показано выше. В Next.js используйте <Head> или next-seo для подстановки hreflang-тегов. Это повышает релевантность страниц для поисковых систем в разных регионах. На практике правильная локализация SEO увеличивает трафик из неосновных языков на 60% за 3 месяца.
Как локализовать медиафайлы?
Strapi не поддерживает локализацию медиа из коробки — каждое изображение привязано к конкретной локали явно. Мы рекомендуем заводить отдельные медиаполя под язык (например, cover_ru, cover_en) или использовать кастомный плагин для линковки. Второй вариант — хранить все изображения в одном поле и управлять их отображением на фронтенде. Экономия времени на управлении медиа может достигать 40%.
Объём работ и гарантии
Что входит в работу
- Аудит текущей схемы и выявление полей, требующих локализации.
- Включение i18n плагина и добавление локалей.
- Настройка Content Types с правильной локализацией атрибутов.
- Оптимизация API для работы с локалью (популяция связанных данных, кеширование).
- Интеграция с фронтендом (Next.js, Nuxt, React) — передача locale в запросы.
- Тестирование всех языковых версий на корректность отображения и SEO.
- Документация по API и процессу добавления новых языков.
- Обучение команды работе с мультиязычным контентом в админке.
Процесс работы
- Аналитика — определяем список языков, карту перевода, требования к медиа.
- Проектирование — схема Content Types с учётом локализации до 15 типов.
- Настройка — включение i18n, конфигурация плагина, миграция существующих данных.
- Интеграция — адаптация API и фронтенда для работы с локалью.
- Тестирование — проверка всех эндпоинтов, переключателя языков, SEO-мета.
- Деплой — развёртывание на продакшн с мониторингом.
Сроки, гарантии и опыт
Настройка i18n для трёх языков с локализацией от 3 до 5 Content Types занимает от 1 до 3 дней. Срок зависит от сложности связей и необходимости миграции данных. Мы даём гарантию 6 месяцев на корректную работу локализации. Если возникнут проблемы — дорабатываем бесплатно. Наш опыт: более 30 успешных проектов с мультиязычным контентом, сертифицированные специалисты по Strapi и Next.js, прозрачная отчётность и документация. Закажите настройку i18n и получите стабильную мультиязычность.
Получите консультацию по вашему проекту — оценим сложность и сроки. Свяжитесь с нами для обсуждения деталей.