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 при каждом запросе — второй файл в этой директории не создаёт новой нагрузки.
Что вы теряете, объединяя всё в один файл
- Смешение ответственности. Если понадобится изменить правило безопасности, вам придётся редактировать тот же файл, где лежит код оптимизации. Это увеличивает риск случайно сломать что-то в другой области.
- Сложность отладки. При конфликте плагинов или проблеме с производительностью раздельные файлы позволяют быстро изолировать источник: переименовали файл — отключили. С одним файлом придётся комментировать блоки кода .
- Риск фатальных ошибок. 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: почему письма попадают в спам».
Если нет времени или желания разбираться самостоятельно – напишите, помогу