Это расширение предоставляет интерфейс к библиотеке преобразования кодировок 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