Рефакторинг кода WordPress: когда и зачем менять структуру работающего сайта
Рефакторинг кода WordPress - это изменение внутренней организации кода темы или плагина без намеренного изменения поведения сайта. Внешне сайт работает так же, внутри код становится проще для понимания и развития.
Такой рефакторинг нужен не для скорости или внешнего вида. Он нужен, когда текущая структура замедляет доработку: правка в одном месте задевает несвязанные части, поиск нужной функции занимает время, дубли приходится править в нескольких файлах сразу.
Что считается рефакторингом в WordPress
Рефакторинг меняет реализацию, а не результат. Переименование функции с сохранением логики - рефакторинг. Вынос повторяющегося запроса WP_Query в отдельную функцию - рефакторинг. Замена вложенных условий ранним выходом - рефакторинг.
Добавление новой опции в админку, исправление неверного вывода цены, ускорение медленного запроса - уже не рефакторинг. В первом случае меняется функциональность, во втором исправляется ошибка, в третьем меняется производительность. Эти задачи могут идти рядом с рефакторингом, но подменять его не должны.
Для WordPress характерно одно ограничение: поведение сайта определяется не только PHP-кодом, но и хуками, шаблонами иерархии, настройками в базе. Поэтому изменение, которое выглядит чисто косметическим, иногда меняет выдачу. Переименование хука, перенос add_action в файл с другим порядком загрузки, правка functions.php без учета дочерней темы - все это уже изменение поведения.
Признаки, что структура мешает развитию
Рефакторинг оправдан, когда есть конкретная помеха. Типовые сигналы для WordPress-проекта:
functions.phpсодержит десятки несвязанных функций: от подключения стилей до обработки форм и правок админки;- одна и та же разметка карточки или один и тот же запрос повторяется в
front-page.php,archive.phpи шорткоде; - шаблон содержит запросы, подготовку данных, форматирование и HTML в одном файле на 300-400 строк;
- обработчики
add_actionиadd_filterразбросаны по файлам, приоритет и количество аргументов приходится искать поиском; - названия функций вида
my_func1,do_stuff,custom_handlerне показывают назначение; - небольшая правка в одном блоке ломает соседние: например, изменение слайдера затрагивает страницу контактов.
Если код стабилен, понятен и давно не требует правок, перечисленные признаки отсутствуют - менять его ради единообразия необязательно.
Типовые приемы
Практичнее начинать с малого: один файл, одна дублирующаяся часть, одна группа хуков.
Разгрузка functions.php
Файл превращается в список подключений, логика уходит в файлы по назначению. Пример ниже рассчитан на обычную родительскую тему. Если файлы находятся в дочерней теме, вместо get_template_directory() используйте get_stylesheet_directory() - первый вызов вернет путь родительской темы, второй - дочерней.
Было:
// functions.php - все подряд
function setup_stuff() { /* ... */ }
function my_slider() { /* ... 80 строк */ }
function contact_form() { /* ... 60 строк */ }
Стало:
// functions.php - только загрузка, для родительской темы
require_once get_template_directory() . '/inc/setup.php';
require_once get_template_directory() . '/inc/slider.php';
require_once get_template_directory() . '/inc/contact-form.php';
Каждая группа получает свое место. Поиск нужного обработчика занимает секунды, а не минуты.
Устранение дублирования
Повторяющийся вывод выносится в одну функцию в inc/template-tags.php или в template-parts. Функция с префиксом the_ предназначена именно для вывода, а не для возврата значения: она получает данные и сразу печатает HTML. Проверка $price === '' здесь уместна, так как get_post_meta() в таком вызове возвращает строку.
// Было в трех шаблонах:
$price = get_post_meta( get_the_ID(), 'price', true );
echo '<div class="card-price">' . esc_html( $price ) . ' руб.</div>';
// Стало - одна функция для вывода:
function the_card_price( $post_id ) {
$price = get_post_meta( $post_id, 'price', true );
if ( $price === '' ) {
return;
}
echo '<div class="card-price">' . esc_html( $price ) . ' руб.</div>';
}
Исправление разметки или экранирования теперь выполняется в одном месте.
Вынос логики из шаблона
// Было в archive.php: запрос, фильтрация, подсчет, HTML вперемешку
// Стало:
$cards = get_featured_cards( 6 );
get_template_part( 'template-parts/cards', null, [ 'cards' => $cards ] );
Шаблон читается сверху вниз без прокрутки через PHP-блоки. Логику выборки можно проверить отдельно.
Упрощение условий
Вложенные проверки заменяются ранним выходом:
// Было:
function can_show_banner( $post ) {
if ( $post ) {
if ( ! is_user_logged_in() ) {
if ( get_post_meta( $post->ID, 'show_banner', true ) ) {
return true;
}
}
}
return false;
}
// Стало:
function can_show_banner( $post ) {
if ( ! $post || is_user_logged_in() ) {
return false;
}
return (bool) get_post_meta( $post->ID, 'show_banner', true );
}
Логика не изменилась, ветвления стало меньше.
Чем рефакторинг отличается от смежных работ
Смешение понятий приводит к неверным ожиданиям. Рефакторинг не обязан ускорять сайт. Код после него может выполняться с той же скоростью, но занимать меньше времени на сопровождение.
| Работа | Меняется ли поведение сайта | Цель |
|---|---|---|
| Рефакторинг | Нет | Упростить понимание и доработку кода |
| Исправление ошибок | Да, неверное поведение заменяется верным | Убрать дефект |
| Оптимизация | Иногда, за счет скорости или ресурсов | Ускорить работу или снизить нагрузку |
| Переписывание темы | Да, почти всегда | Заменить архитектуру или стек целиком |
Как менять код без нарушения работы сайта
Порядок, который снижает риск поломок:
- Зафиксируйте текущее поведение. Проверьте затронутые страницы, формы, хуки, вывод в админке. Для повторяемых сценариев достаточно короткого списка: главная, затронутый шаблон, форма, мобильная версия.
- Работайте в Git на отдельной ветке. Каждое изменение - отдельный коммит с понятным сообщением. Откат одного шага не должен затрагивать остальные.
- Меняйте код на копии, а не на рабочем сайте. Локальная копия или тестовый поддомен с той же версией WordPress, темы и плагинов.
- Проверяйте хуки и иерархию шаблонов после переноса. Регистрация обработчика через
add_actionи выполнение его callback - разные события. Порядок подключения файлов влияет на момент регистрации, а перенос регистрации может изменить порядок выполнения обработчиков с одинаковым приоритетом. Условная декларация черезfunction_exists()позволяет дочерней теме объявить свою реализацию раньше родительской, но для этого необходимо учитывать порядок загрузкиfunctions.php: файл дочерней темы загружается перед файлом родительской. - Сверяйте результат с исходным поведением вручную по тем же пользовательским сценариям: те же страницы, те же формы, те же письма и уведомления. Такая ручная регрессионная проверка нужна всегда, независимо от наличия автотестов.
- Автоматизированные тесты подключайте там, где они уже есть или где логика критична: расчеты цен, права доступа, обработка форм. Ради одного переименования разворачивать тестовый каркас с нуля избыточно.
После переноса полезно сравнить дифф построчно: в нем должны остаться только структурные изменения, без правок логики и разметки.
Когда код лучше не трогать
Рефакторинг без конкретной помехи дает мало пользы и создает риск. Отложите изменения, если:
- участок стабилен и не входит в ближайшие задачи;
- дублирование встречается дважды и не растет - выделение абстракции рано;
- правка затрагивает устаревший плагин без исходников и документации, а замена не планируется;
- единственная причина - личные предпочтения по стилю именования или порядку файлов.
Критерий простой: если после изменения следующему разработчику станет проще внести конкретное запланированное изменение - работа оправдана. Если станет только красивее - можно подождать.
