Iconv set encoding: примеры (PHP)

Пример настройки кодировок для входящих и исходящих данных:

// Установка кодировки для входных данных
iconv_set_encoding('input_encoding', 'CP1251');

// Установка кодировки для выходных данных
iconv_set_encoding('output_encoding', 'UTF-8');

// Проверка текущих настроек
$internal = iconv_get_encoding('input_encoding');
$output = iconv_get_encoding('output_encoding');

echo 'Входная кодировка: ' . $internal . '<br>';
echo 'Выходная кодировка: ' . $output;

Входная кодировка: CP1251
Выходная кодировка: UTF-8

// Установка внутренней кодировки для iconv
iconv_set_encoding('internal_encoding', 'UTF-8');

// Теперь функция iconv будет использовать UTF-8 по умолчанию
$result = iconv('CP1251', null, 'Тестовый текст');
var_dump($result);

string(23) "Тестовый текст"

В PHP существуют альтернативные способы работы с кодировками:

• mb_internal_encoding() — устанавливает внутреннюю кодировку для многобайтовых строк. Предпочтительнее для работы с многобайтовыми кодировками, такими как UTF-8, так как обеспечивает более полную поддержку символов.
• iconv_get_encoding() — получает текущие настройки кодировки модуля iconv. Используется совместно с iconv_set_encoding для проверки установленных значений.
• mb_convert_encoding() — преобразует строку из одной кодировки в другую. Более гибкая функция, позволяющая явно указывать кодировки для каждого преобразования.

Функция iconv_set_encoding полезна при необходимости глобальной настройки поведения модуля iconv для всего скрипта. Для точечных преобразований лучше использовать iconv() или mb_convert_encoding() с явным указанием кодировок.

// Попытка установить несуществующую кодировку
$result = iconv_set_encoding('input_encoding', 'UNKNOWN_ENCODING');
if ($result === false) {
    echo 'Ошибка установки кодировки';
}

Ошибка установки кодировки

// Передача недопустимого значения в параметр type
$result = iconv_set_encoding('wrong_type', 'UTF-8');
var_dump($result);

bool(false)

// Установка разных кодировок через разные функции может вызвать проблемы
iconv_set_encoding('internal_encoding', 'CP1251');
mb_internal_encoding('UTF-8');

// При последующих преобразованиях могут возникнуть неожиданные результаты

В PHP 8 функция iconv_set_encoding сохранила обратную совместимость. Существенных изменений в поведении функции не произошло. Однако в PHP 8 была улучшена обработка ошибок и строгость типов.

Важное изменение связано с модулем iconv в целом: в PHP 8.2 появились уведомления об устаревании для некоторых унаследованных настроек и функций, но iconv set encoding остается поддерживаемой.

Рекомендуется проверять актуальность поддерживаемых кодировок в документации конкретной версии PHP, так как список может меняться между минорными версиями.

// Глобальная настройка для обработки файлов в Windows-1251
iconv_set_encoding('input_encoding', 'CP1251');
iconv_set_encoding('output_encoding', 'UTF-8');
iconv_set_encoding('internal_encoding', 'UTF-8');

// Чтение файла в CP1251 и автоматическое преобразование
$content = file_get_contents('windows_file.txt');
// Дальнейшая обработка в UTF-8
$uppercase = mb_strtoupper($content, 'UTF-8');
echo $uppercase;

// Настройка кодировок и буферизации с преобразованием
iconv_set_encoding('internal_encoding', 'UTF-8');
iconv_set_encoding('output_encoding', 'CP1251');

ob_start('ob_iconv_handler'); // Использует установленные кодировки

echo 'Текст в UTF-8 будет преобразован в CP1251';

$output = ob_get_clean();
// $output теперь в кодировке CP1251

// Сохранение текущих настроек и временное изменение
$original_settings = iconv_get_encoding('all');

// Временная установка новой кодировки
iconv_set_encoding('internal_encoding', 'KOI8-R');

// Выполнение операций, требующих KOI8-R
$converted = iconv('UTF-8', null, 'Пример');

// Восстановление оригинальных настроек
foreach ($original_settings as $type => $charset) {
    iconv_set_encoding($type, $charset);
}

// Динамическая настройка в зависимости от источника данных
$data_sources = [
    'api' => 'UTF-8',
    'legacy_db' => 'CP1251',
    'external_file' => 'KOI8-R'
];

foreach ($data_sources as $source => $encoding) {
    iconv_set_encoding('input_encoding', $encoding);
    // Обработка данных из текущего источника
    process_data_from_source($source);
}

// Настройка для работы с устаревшей системой в DOS-кодировке
iconv_set_encoding('output_encoding', 'CP866');
iconv_set_encoding('input_encoding', 'CP866');

// Генерация текста для старой системы
$old_system_text = 'Данные для старой системы';

// Преобразование происходит автоматически при использовании iconv
$for_old_system = iconv('UTF-8', null, $old_system_text);

// Отправка в систему, ожидающую CP866

Iconv set encoding в Python

В Python работа с кодировками осуществляется через методы строк encode() и decode(). Глобальной настройки кодировки, аналогичной PHP, обычно не требуется.

# Пример преобразования кодировок в Python
text = 'Пример текста'
encoded = text.encode('cp1251')
decoded = encoded.decode('cp1251')
print(decoded)

Пример текста

Iconv set encoding в Javascript

В JavaScript стандартной кодировкой является UTF-16. Для преобразования кодировок используют объекты TextEncoder и TextDecoder.

// Пример работы с кодировками в JavaScript
const encoder = new TextEncoder();
const decoder = new TextDecoder('windows-1251');

const encoded = encoder.encode('Пример текста');
const decoded = decoder.decode(new Uint8Array([207, 240, 232, 236, 229, 240]));
console.log(decoded);

Пример

Iconv set encoding в MySQL

В MySQL настройки кодировки устанавливаются на уровне соединения, таблицы или столбца через команды SET NAMES или параметры подключения.

-- Установка кодировки соединения в MySQL
SET NAMES 'utf8mb4';
-- или при подключении
-- mysqli_set_charset($link, 'utf8mb4');