Перекодировать данные Encoding::convertEncoding
Модуль: main — подключать отдельно не нужно
Метод Encoding::convertEncoding переводит строку или массив из одной кодировки в другую функцией mb_convert_encoding. В массиве метод перекодирует и ключи, и значения на всех уровнях вложенности.
Сигнатура метода в классе Bitrix\Main\Text\Encoding:
public static function convertEncoding($data, $charsetFrom, $charsetTo)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| data* | string, array, SplFixedArray |
Задает данные. Значения других типов метод возвращает без изменений |
| charsetFrom* | string |
Задает исходную кодировку, например Windows-1251. Регистр не важен |
| charsetTo* | string |
Задает целевую кодировку, например UTF-8 |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает перекодированные данные того же вида — строку, массив или SplFixedArray.
Метод возвращает данные без изменений и без ошибки, если одна из кодировок пустая или неизвестна mbstring, а также если кодировки совпадают.
Метод обрезает пробелы в названиях кодировок, приводит их к нижнему регистру и заменяет некоторые названия. Например, ks_c_5601-1987 и похожие названия он заменяет на euc-kr, а windows-1257 — на ISO-8859-13.
Если исходная кодировка — ровно UTF-16, метод определяет порядок байтов по метке в начале строки и отрезает метку. Без метки метод читает строку как UTF-16LE.
Примеры
Пример. Код переводит строку CSV из Windows-1251 в UTF-8:
<?php
use Bitrix\Main\Text\Encoding;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$line = mb_convert_encoding('Килограмм;kg', 'Windows-1251', 'UTF-8');
$fields = explode(';', Encoding::convertEncoding($line, 'Windows-1251', 'UTF-8'));
echo $fields[0];