Настройка кодировки в HTTP-заголовках PHP

Раздел: Работа с HTTP заголовками -> Установка MIME-типов

Основные подходы к установке кодировки в HTTP-заголовках

Как наиболее надёжно указать кодировку для HTML-страницы?

Наиболее эффективный способ – использовать функцию header() вместе с MIME-типом и параметром charset. Например, для UTF-8:

header('Content-Type: text/html; charset=utf-8');

Php header text (установка заголовка content-type: text/plain)

Этот вызов должен выполняться до любого вывода данных (в том числе пробелов и HTML-тегов). Кодировка, указанная в заголовке, сообщает браузеру, как интерпретировать символы. Если файл PHP сохранён в UTF-8 без BOM, проблем не возникает.

Типичная ошибка: Headers already sent. Возникает, когда перед вызовом header() уже был отправлен вывод (например, пробел перед <?php или echo). Решение: проверить отсутствие вывода, использовать буферизацию (ob_start()) либо разместить header() в самом начале скрипта.

Цель: гарантировать, что браузер правильно отобразит текст на странице. Используется для всех HTML-документов, генерируемых PHP.

Как задать кодировку windows-1251 для страницы?

header('Content-Type: text/html; charset=windows-1251');

Php header charset (установка кодировки заголовка в php)

В этом случае исходный код PHP-файла должен быть сохранён в кодировке windows-1251, иначе символы кириллицы будут отображаться кракозябрами. Дополнительно можно использовать mb_http_output('windows-1251') и ob_start('mb_output_handler') для автоматической конвертации.

Частая проблема: несоответствие кодировки файла и объявленной в заголовке. Решение: проверить кодировку файла в редакторе, использовать UTF-8 как универсальный вариант.

Цель: поддержка старых систем или специфических требований.

Как установить кодировку для JSON-ответа?

header('Content-Type: application/json; charset=utf-8');

Необходимо при возврате данных в формате JSON из API. Кодировка UTF-8 рекомендована стандартом. Важно, чтобы сам JSON был валидным (использовать json_encode).

Ошибка: если JSON содержит символы, не входящие в UTF-8, они будут заменены или вызовут ошибку. Применяйте JSON_UNESCAPED_UNICODE для корректного отображения кириллицы.

Как установить кодировку для RSS или XML?

header('Content-Type: application/rss+xml; charset=utf-8');

Для XML-лент (RSS, Atom) также указывается charset, но сам XML должен содержать декларацию <?xml version="1.0" encoding="UTF-8"?>. Заголовок должен согласовываться с внутренней кодировкой.

Как указать кодировку при скачивании файла с сервера?

header('Content-Type: text/plain; charset=utf-8');
header('Content-Disposition: attachment; filename="file.txt"');

Если файл содержит текст, кодировка влияет на его открытие в браузере или текстовом редакторе. Для нетекстовых файлов (изображения, архивы) charset не имеет смысла.

Проблема: некоторые браузеры игнорируют charset для загружаемых файлов. Рекомендуется сохранять файл в требуемой кодировке заранее.

Как изменить кодировку для всего ответа с помощью буферизации?

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

mb_http_output('utf-8');
ob_start('mb_output_handler');
header('Content-Type: text/html; charset=utf-8');

Функция mb_output_handler автоматически конвертирует внутреннюю кодировку (установленную через mb_internal_encoding) в указанную для вывода.

Ошибка: если внутренняя кодировка не совпадает с фактической кодировкой строк, могут появиться искажения. Убедитесь, что все строки в скрипте имеют одинаковую кодировку.

Расширенные примеры и нестандартные ситуации

Установка кодировки с учётом предпочтений браузера

Используем заголовок Accept-Language для выбора кодировки (например, русский язык – windows-1251, английский – utf-8).

Пример

// Определяем язык из HTTP-заголовка
$lang = substr($_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? 'en', 0, 2);
if ($lang === 'ru') {
    header('Content-Type: text/html; charset=windows-1251');
    mb_internal_encoding('windows-1251');
    mb_http_output('windows-1251');
    ob_start('mb_output_handler');
} else {
    header('Content-Type: text/html; charset=utf-8');
}

Браузер с русским языком получит заголовок charset=windows-1251, с английским – utf-8.

Динамическая смена кодировки для разных разделов сайта

В многоязычном проекте можно переключать кодировку в зависимости от пользователя.

Пример

// Предположим, пользователь выбрал кодировку в сессии
session_start();
$charset = $_SESSION['charset'] ?? 'utf-8';
header("Content-Type: text/html; charset=$charset");
// Далее вывод контента в соответствующей кодировке

Установка кодировки через .htaccess (сервер Apache)

Можно настроить кодировку для всех PHP-файлов на сервере без изменения кода:

Пример

AddDefaultCharset utf-8
# или для определённых расширений

  Header set Content-Type "text/html; charset=utf-8"

Этот метод подходит, если все файлы имеют одинаковую кодировку. Недостаток: нельзя менять динамически.

Установка кодировки для ответа в формате CSV с BOM

Для Excel требуется BOM (Byte Order Mark) в UTF-8. Пример:

Пример

header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="export.csv"');
echo "\xEF\xBB\xBF"; // UTF-8 BOM
// вывод CSV-данных

Excel откроет CSV с корректным отображением кириллицы.

Проверка и удаление уже установленных заголовков

Иногда нужно заменить кодировку после того, как заголовок уже был отправлен (при буферизации).

Пример

header_remove('Content-Type');
header('Content-Type: text/html; charset=iso-8859-1');

Старый заголовок удаляется, новый устанавливается. Работает только до вывода.

Установка кодировки для отправки почты с помощью mail()

Хотя это не HTTP-заголовок, но для полноты:

Пример

$subject = "=?UTF-8?B?" . base64_encode('Тема письма') . "?=";
$headers = "MIME-Version: 1.0\r\n";
$headers .= "Content-type: text/plain; charset=utf-8\r\n";
mail('user@example.com', $subject, 'Текст письма', $headers);

Почтовый клиент правильно интерпретирует кодировку.

Комбинирование нескольких заголовков с кодировкой

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

Пример

header('Content-Type: image/png'); // charset не нужен
readfile('image.png');

Браузер корректно отображает изображение. Если ошибочно добавить charset, некоторые браузеры могут игнорировать тип.

Установка кодировки заголовка в PHP - comments

Php header charset (php)