Как избежать проблем с кодировкой (charset) в WordPress: практические советы и примеры

Автор: Виктория Ковалева | Опубликовано: 01.04.2026

Проблемы с кодировкой в WordPress – одна из частых технических сложностей, с которой сталкиваются разработчики и администраторы сайтов. Неправильная кодировка символов приводит к отображению искажённых текстов, вопросительных знаков и кракозябр вместо кириллицы или других языков. В этой статье подробно разберём, как правильно настроить кодировку в WordPress, чтобы избежать подобных проблем, а также рассмотрим конкретные примеры и решения с кодом.

Что такое кодировка и почему она важна в WordPress

Кодировка (charset) – это набор символов и правил, которые определяют, как текст хранится и отображается на сайте. Самая распространённая кодировка для современных сайтов — UTF-8. Если кодировка не совпадает на уровне базы данных, шаблонов и HTTP-заголовков, текст будет отображаться некорректно.

В WordPress кодировка влияет на:

Хранение данных в базе данных MySQL/MariaDB;
Вывод текста на страницах сайта;
Обмен данными через REST API и AJAX;
Импорт/экспорт данных и резервные копии.

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

Настройка кодировки в базе данных WordPress

По умолчанию WordPress рекомендует использовать utf8mb4 — расширенный вариант UTF-8, поддерживающий все символы, включая эмодзи. Проверьте текущие настройки базы данных, выполнив SQL-запрос:

SHOW VARIABLES LIKE 'character_set_database';
SHOW VARIABLES LIKE 'collation_database';

В идеале должно быть utf8mb4_unicode_ci или utf8mb4_general_ci для сравнения.

Если база данных создана с другой кодировкой, её можно изменить, выполнив последовательность команд:

ALTER DATABASE wp_database CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_posts CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- Повторить для всех таблиц

Учтите, что перед изменениями нужно сделать полную резервную копию базы данных.

Настройка кодировки в файле wp-config.php

В файле wp-config.php должны быть указаны правильные параметры:

define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', '');

Если в вашем файле указана другая кодировка – например, utf8 или latin1, замените её на utf8mb4 для корректной поддержки всех символов.

Правильная отправка HTTP-заголовков и мета-тегов

Кодировка должна быть указана в HTTP-заголовках и в мета-тегах страниц. WordPress по умолчанию выводит в <head>:

<meta charset="UTF-8" />

Если ваш шаблон или плагины меняют этот тег или добавляют другой, это может стать причиной конфликтов. Убедитесь, что в шаблоне темы (обычно в header.php) стоит именно UTF-8:

<meta charset="UTF-8" />

Также можно добавить отправку заголовка с кодировкой через PHP, чтобы гарантировать её корректность:

function wp_host_send_charset_header() {
    if (!headers_sent()) {
        header('Content-Type: text/html; charset=UTF-8');
    }
}
add_action('send_headers', 'wp_host_send_charset_header');

Настройка кодировки для AJAX и REST API запросов

Если вы используете AJAX или REST API для обмена данными, убедитесь, что они обрабатывают UTF-8 корректно. Например, при создании собственного AJAX-хендлера в WordPress можно явно указать кодировку в заголовках:

function wp_host_custom_ajax_handler() {
    header('Content-Type: application/json; charset=UTF-8');
    $data = array('message' => 'Пример текста с кириллицей');
    echo json_encode($data, JSON_UNESCAPED_UNICODE);
    wp_die();
}
add_action('wp_ajax_custom_action', 'wp_host_custom_ajax_handler');
add_action('wp_ajax_nopriv_custom_action', 'wp_host_custom_ajax_handler');

Обратите внимание на параметр JSON_UNESCAPED_UNICODE – он позволяет корректно выводить юникод символы без экранирования.

Использование плагинов для контроля и исправления кодировки

Существуют плагины, которые помогают выявлять и исправлять проблемы с кодировкой:

Clearfy Pro – плагин для оптимизации и исправления множества ошибок, в том числе связанных с кодировкой и базой данных.
WPCommunity – плагин для управления сообществом, который корректно работает с кодировкой UTF-8 в пользовательских данных.

Использование таких инструментов позволяет минимизировать риски появления проблем с символами.

Советы по работе с файлами и редакторами

Ещё одна распространённая причина проблем с кодировкой – неправильное сохранение файлов PHP, шаблонов и конфигураций в редакторах. Всегда сохраняйте файлы в формате UTF-8 без BOM. Многие редакторы, такие как Visual Studio Code, Sublime Text или PHPStorm, позволяют выбрать формат при сохранении.

Если вы импортируете или экспортируете данные через CSV или XML, убедитесь, что файлы тоже в UTF-8, иначе при импорте в WordPress могут появиться искажённые символы.

Дополнительные рекомендации и проверки

Чтобы проверить кодировку базы данных и таблиц, можно использовать плагин WP-DBManager или phpMyAdmin. В phpMyAdmin обратите внимание на вкладку "Operations" для каждой таблицы и убедитесь, что там стоит utf8mb4_unicode_ci.

Также рекомендуется использовать функцию wp_host_db_check_charset() для проверки кодировки базы данных в коде (пример ниже):

function wp_host_db_check_charset() {
    global $wpdb;
    $charset = $wpdb->get_var("SELECT @@character_set_database");
    $collation = $wpdb->get_var("SELECT @@collation_database");
    return array('charset' => $charset, 'collation' => $collation);
}
// Использование:
$charset_info = wp_host_db_check_charset();
echo 'Charset: ' . $charset_info['charset'] . ', Collation: ' . $charset_info['collation'];

Итог

Точный контроль и настройка кодировки на всех уровнях WordPress – база для корректного отображения контента и стабильной работы сайта. Следуя рекомендациям из статьи, вы сможете избежать проблем с кодировкой, обеспечить совместимость с любыми языками и символами, а также повысить качество и стабильность вашего проекта.