Главная / Блог / Рефакторинг кода WordPress

Рефакторинг кода 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 );
}

Логика не изменилась, ветвления стало меньше.

Чем рефакторинг отличается от смежных работ

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

РаботаМеняется ли поведение сайтаЦель
РефакторингНетУпростить понимание и доработку кода
Исправление ошибокДа, неверное поведение заменяется вернымУбрать дефект
ОптимизацияИногда, за счет скорости или ресурсовУскорить работу или снизить нагрузку
Переписывание темыДа, почти всегдаЗаменить архитектуру или стек целиком

Как менять код без нарушения работы сайта

Порядок, который снижает риск поломок:

  1. Зафиксируйте текущее поведение. Проверьте затронутые страницы, формы, хуки, вывод в админке. Для повторяемых сценариев достаточно короткого списка: главная, затронутый шаблон, форма, мобильная версия.
  2. Работайте в Git на отдельной ветке. Каждое изменение - отдельный коммит с понятным сообщением. Откат одного шага не должен затрагивать остальные.
  3. Меняйте код на копии, а не на рабочем сайте. Локальная копия или тестовый поддомен с той же версией WordPress, темы и плагинов.
  4. Проверяйте хуки и иерархию шаблонов после переноса. Регистрация обработчика через add_action и выполнение его callback - разные события. Порядок подключения файлов влияет на момент регистрации, а перенос регистрации может изменить порядок выполнения обработчиков с одинаковым приоритетом. Условная декларация через function_exists() позволяет дочерней теме объявить свою реализацию раньше родительской, но для этого необходимо учитывать порядок загрузки functions.php: файл дочерней темы загружается перед файлом родительской.
  5. Сверяйте результат с исходным поведением вручную по тем же пользовательским сценариям: те же страницы, те же формы, те же письма и уведомления. Такая ручная регрессионная проверка нужна всегда, независимо от наличия автотестов.
  6. Автоматизированные тесты подключайте там, где они уже есть или где логика критична: расчеты цен, права доступа, обработка форм. Ради одного переименования разворачивать тестовый каркас с нуля избыточно.

После переноса полезно сравнить дифф построчно: в нем должны остаться только структурные изменения, без правок логики и разметки.

Когда код лучше не трогать

Рефакторинг без конкретной помехи дает мало пользы и создает риск. Отложите изменения, если:

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

Критерий простой: если после изменения следующему разработчику станет проще внести конкретное запланированное изменение - работа оправдана. Если станет только красивее - можно подождать.

Частые вопросы

Чтобы не пропустить новые материалы

Короткий дайджест вечером в понедельник. Без спама.

Выберите, что получать

Обсудим ваш проект

Расскажите о вашем бизнесе, покажите текущий сайт или просто опишите задачу в свободной форме. Я изучу вводные, предложу решение и сориентирую по срокам и смете.

Отвечаю в течение нескольких часов в рабочее время.

Защита от спама – Yandex SmartCaptcha

Если вам удобнее обсудить всё текстом без заполнения форм – напишите напрямую: в Telegram или на sergei@kruglov.net

Удобнее голосом? Напишите пару слов о задаче - договоримся об удобном времени созвона на 15-20 минут, и я пришлю свой номер телефона.