Перевести строку в UTF-8 Encoding::convertToUtf

Модуль: main — подключать отдельно не нужно

Метод Encoding::convertToUtf переводит строку в UTF-8, если она еще не в UTF-8. Исходную кодировку метод не определяет, а берет из настроек.

Сигнатура метода в классе Bitrix\Main\Text\Encoding:

public static function convertToUtf($string)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
string* string Задает строку

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

Возвращаемое значение

Метод возвращает строку string.

Если detectUtf8 признает строку корректной строкой UTF-8, метод возвращает ее без изменений. Иначе метод перекодирует строку из кодировки по умолчанию. Метод берет ее по порядку из секции default_charset настроек ядра в .settings.php или .settings_extra.php, из константы BX_DEFAULT_CHARSET или использует Windows-1251.

Если кодировка по умолчанию — UTF-8 или неизвестна mbstring, метод возвращает исходную строку без изменений.

Примеры

Пример. Код переводит в UTF-8 строку в Windows-1251 и не меняет строку, которая уже в UTF-8:

<?php
use Bitrix\Main\Text\Encoding;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$legacy = mb_convert_encoding('Килограмм', 'Windows-1251', 'UTF-8');

echo Encoding::convertToUtf($legacy) . ' ' . Encoding::convertToUtf('Метр');

Смотрите также