LIV. Функции iconv

Введение

Это расширение предоставляет интерфейс к библиотеке преобразования кодировок iconv. Набор поддерживаемых кодировок зависит от реализации iconv в вашей системе. На некоторых платформах iconv может работать ненормально, в таких случаях рекомендуется установить библиотеку GNU libiconv.

Начиная с PHP 5.0.0, это в расширение добавлены некоторые вспомогательные функции, помогающие при написании сценариев, работающих с несколькими языками.

Требования

Операционные системы, отвечающие стандартам POSIX, поставляются с C-библиотеками, предоставляющими функциональность iconv. Иначе, вам придётся установить библиотеку libiconv от GNU.

Установка

Чтобы расширение было доступно, нужно указать ключ --with-iconv[=DIR] при запуске сценария конфигурирования.

Примечание для пользователей Windows®: Чтобы расширение было доступно, поместите библиотеку с именем iconv.dll или iconv-1.3.dll (для версий до 4.2.1), которая входит в поставку PHP для Windows®, в одну из её системных папок.
Этот модуль является частью PHP начиная с версии 5, так что библиотеки iconv.dll и php_iconv.dll более не нужны.

Настройка во время выполнения

Поведение этих функций зависит от установок в php.ini.

Таблица 1. Конфигурационные параметры, касающиеся Iconv

Параметр	Значение по умолчанию	Переменная окружения
iconv.input_encoding	ICONV_INPUT_ENCODING	PHP_INI_ALL
iconv.output_encoding	ICONV_OUTPUT_ENCODING	PHP_INI_ALL
iconv.internal_encoding	ICONV_INTERNAL_ENCODING	PHP_INI_ALL

Для подробностей о константах PHP_INI_* см. ini_set().

Замечание: На данный момент iconv.input_encoding никак не используется.

Типы ресурсов

Данное расширение не определяет никакие типы ресурсов.

Предопределенные константы

Начиная с PHP 4.3.0 возможно узнать во время выполнения, какая реализация iconv используется расширением.

Таблица 2. Константы iconv

Имя	Тип	Описание
ICONV_IMPL	string	Реализация
ICONV_VERSION	string	Версия реализации

Замечание: Используйте эти константы для написания сценариев, независимых от реализации.

Начиная с PHP 5.0.0, доступны также следующие константы:

Таблица 3. константы iconv, доступные начиная с PHP 5.0.0

Имя	Тип	Описание
ICONV_MIME_DECODE_STRICT	integer	Битовая маска, используемая для iconv_mime_decode()
ICONV_MIME_DECODE_CONTINUE_ON_ERROR	integer	Битовая маска, используемая для iconv_mime_decode()

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

См. также Функции GNU Recode.

Содержание
iconv_get_encoding -- Возвращает значение внутренних переменных расширения
iconv_mime_decode_headers -- Декодирует несколько полей заголовка MIME
iconv_mime_decode -- Decodes a MIME header field
iconv_mime_encode -- Composes a MIME header field
iconv_set_encoding -- Устанавливает значение одной из внутренних переменных
iconv_strlen -- Возвращает количество символов в строке
iconv_strpos -- Возвращает позицию первого вхождения подстроки
iconv_strrpos -- Возвращает позицию последнего вхождения символа
iconv_substr -- Возвращает подстроку
iconv -- Преобразовывает символы строки в другую кодировку
ob_iconv_handler -- Convert character encoding as output buffer handler