Главная » Блог » WordPress MU-плагины: как организовать код безопасности и оптимизации без потери производительности

WordPress MU-плагины: как организовать код безопасности и оптимизации без потери производительности

MU-плагины (Must-Use Plugins) — это особый тип расширений WordPress, которые загружаются автоматически, не требуют активации и не могут быть отключены через админ-панель . Именно поэтому они идеально подходят для инфраструктурного кода: заголовков безопасности, логирования и оптимизаций, которые не должны зависеть от темы или действий администратора.

Разбираемся, какие сниппеты стоит перенести в MU-плагины, как разделить их на логические файлы и почему разделение не жертвует скоростью загрузки.


1. Что и куда класть: критерий размещения

Главный принцип: 
инфраструктурный код → MU-плагин
привязанное к шаблонам → дочерняя тема

Это разделение продиктовано механикой WordPress. Код, который должен работать независимо от активной темы (заголовки, логирование, отключение неиспользуемых функций ядра), логичнее держать в MU-плагинах. Код, который зависит от конкретных шаблонов или файлов темы (preload конкретного hero-изображения, условная загрузка скриптов для шаблона контактов), остаётся в дочерней теме .

Отдельный случай — настройки, которые «привязаны к теме» только потому, что их туда положили. Классический пример — phpmailer_init в functions.php темы для настройки SMTP. Формально это код темы, но по смыслу — инфраструктура: при смене темы настройка исчезает, и письма снова уходят через sendmail. Такие вещи надёжнее держать в MU-плагине. Подробнее о том, почему это важно для почты, — в статье «Почему письма с формы не доходят: плагин перехватил wp_mail» и в статье «Почтовая система: MX, SMTP и веб-интерфейс…».

🔒Безопасность (security-hardening)

СниппетЗачем
CSP через Report-OnlyСбор отчётов о нарушениях перед ужесточением политики
Логирование входов и смены ролейМинимальный аудит действий с аккаунтами
Отключение XML-RPCЗакрытие канала для брутфорса и pingback-DDoS
Ограничение REST API для гостейБлокировка /wp/v2/users и других чувствительных эндпоинтов
Удаление лишних мета-теговrsd_link, wlwmanifest_link, Emoji-скрипты

Все эти сниппеты относятся к «гигиене» и безопасности уровня инфраструктуры. Они не должны зависеть от того, какую тему вы установили сегодня.

⚡Оптимизация (performance-tweaks)

СниппетЗачем
Отключение Emoji-скриптовУбирает лишний JS и CSS с каждой страницы
defer/async для некритичных скриптовНе блокирует рендеринг
Preload LCP-изображенияУскоряет загрузку главного изображения (но зависит от шаблона!)
Нативная ленивая загрузкаДля старого контента, где WordPress не проставил loading="lazy"
Условная загрузка скриптовНе грузить скрипт контактной формы везде

Здесь уже есть нюанс: preload LCP-изображения и условная загрузка скриптов привязаны к шаблонам. Их место — в дочерней теме. В MU-плагин имеет смысл выносить только то, что не зависит от темы: например, принудительная ленивая загрузка для старого контента.


2. Почему два файла не медленнее одного

Бытует мнение: «Чем меньше файлов, тем быстрее». Для обычных плагинов это не совсем верно, а для MU-плагинов — тем более.

Механизм загрузки MU-плагинов

MU-плагины загружаются до обычных плагинов, простым циклом по файлам в директории wp-content/mu-plugins/. Они не проверяют статус активации и не делают запросов к базе данных для получения списка активных плагинов . Эти накладные расходы исчезают независимо от того, один у вас файл или два.

Что реально добавляет второй файл

Один дополнительный системный вызов include. С точки зрения TTFB (Time To First Byte) это настолько мало, что измерить разницу практически невозможно. WordPress и так сканирует директорию mu-plugins при каждом запросе — второй файл в этой директории не создаёт новой нагрузки.

Что вы теряете, объединяя всё в один файл

  1. Смешение ответственности. Если понадобится изменить правило безопасности, вам придётся редактировать тот же файл, где лежит код оптимизации. Это увеличивает риск случайно сломать что-то в другой области.
  2. Сложность отладки. При конфликте плагинов или проблеме с производительностью раздельные файлы позволяют быстро изолировать источник: переименовали файл — отключили. С одним файлом придётся комментировать блоки кода .
  3. Риск фатальных ошибок. MU-плагины нельзя отключить через админ-панель. Если один файл содержит фатальную ошибку, сайт получает «белый экран». Разделение на несколько файлов снижает вероятность того, что ошибка в оптимизации парализует всю защиту. На время разработки MU-плагинов включайте WP_DEBUG и WP_DEBUG_LOG — так ошибки будут писаться в лог, а не только в «белый экран». И тестируйте на staging, а не на продакшене.

3. Практическая рекомендация: четыре файла с контролем порядка

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

MU-плагины загружаются в алфавитном порядке имён файлов . Это можно использовать:

wp-content/mu-plugins/
├── 00-security-hardening.php      — заголовки, логирование, XML-RPC, лишние мета-теги
├── 10-performance-tweaks.php     — Emoji, defer/async, lazy load для старого контента
├── 20-misc-fixes.php             — всё, что не вошло в 00 и 10
└── 30-block-theme-fixes.php      — фиксы, связанные с блочной темой (FSE)
  • 00- гарантирует, что код безопасности (заголовки, фильтры раннего запуска) выполнится первым.
  • 10- загрузится после — оптимизация не зависит от security-кода.
  • 20- — «разное»: правки поведения ядра, не связанные ни с безопасностью, ни с производительностью, ни с блочной темой (например, изменение интервала крон-задач, отключение автосохранения).
  • 30- — фиксы, завязанные на блочную тему (FSE): пагинация Query Loop, вывод wp:query, обход известных багов Gutenberg.

Такое разделение даёт:

  • Ясность кода: безопасность, оптимизация, «разное» и FSE-фиксы — отдельно.
  • Детерминированный порядок: префиксы 00-, 10-, 20-, 30- исключают неожиданности.
  • Нулевые накладные расходы: каждый дополнительный файл — это один include, не более.

Почему 30-block-theme-fixes.php — отдельно

Фикс пагинации блога (13 карточек вместо 12) — наглядный пример. Проблема возникает из-за поведения блока Query Loop в блочной теме: WordPress добавляет закреплённый пост поверх лимита perPage, а параметр "sticky":"exclude" в разметке блока на фронтенде не срабатывает. Решение — принудительно игнорировать sticky-посты на уровне основного запроса.
Код не относится ни к безопасности, ни к производительности в чистом виде — это исправление поведения ядра под блочную тему. Поэтому ему место в отдельном файле, а не в 10-performance-tweaks.php.


4. Важное ограничение: что остаётся в дочерней теме

Не всё стоит тащить в MU-плагины. Следующие сниппеты привязаны к шаблонам и должны жить в functions.php дочерней темы:

  • Preload LCP-изображения: путь к hero-изображению зависит от шаблона главной страницы.
  • Условная загрузка скриптов: проверка is_page_template() работает только в контексте темы.
  • defer/async для конкретных скриптов темы: если скрипт регистрируется темой, логичнее управлять им там же.

Принцип простой: если код содержит get_theme_file_uri(), is_page_template() или ссылается на конкретный файл шаблона — это территория дочерней темы.


Итог

MU-плагины — это не про «запихнуть всё в один файл для скорости». Это про надёжность и предсказуемость. Разделение на 00-security-hardening.php, 10-performance-tweaks.php, 20-misc-fixes.php и 30-block-theme-fixes.php даёт вам:

  • Чистое разделение ответственности
  • Детерминированный порядок загрузки через алфавитные префиксы
  • Лёгкость отладки при конфликтах
  • Нулевые измеримые накладные расходы на производительность

И помните: если MU-плагин настраивает отправку почты (например, через phpmailer_init), стоит проверить, что письма уходят через аутентифицированный SMTP, а PTR-запись IP совпадает с доменом сайта. Иначе даже правильно организованный код не спасёт от фильтров на стороне получателя —  «Обратная DNS-запись и FCrDNS: почему письма попадают в спам».

Если нет времени или желания разбираться самостоятельно – напишите, помогу

Наверх