Referencia de funciones
PHP Manual

Funciones iconv

Introducción

Este módulo contiene una interfaz con la facilidad de conversión de juegos de caracteres iconv. Con éste módulo, es posible convertir una cadena representada por un juego de caracteres local a una representada por otro juego de caracteres, que puede ser el juego de caracteres Unicode. Los juegos de caracteres soportados dependen de la implementación de iconv en su sistema. Note que la función iconv en algunos sistemas puede que no funcione como lo espera. En tal caso, sería una buena idea instalar la biblioteca » libiconv GNU. Es muy probable que consiga unos resultados más consistentes.

A partir de PHP 5.0.0, esta extensión viene con varias funciones utilitarias que le ayudan a escribir scripts multi-lingües. Echemos un vistazo a las siguientes secciones para explorar las nuevas características.

Requisitos

No necesita de nada si el sistema que usa es uno de los sistemas recientes compatibles con POSIX, ya que las bibliotecas C estándar que vienen con ellos ofrecen la facilidad iconv. De otro modo, es necesario instalar la biblioteca » libiconv en su sistema.

Instalación

Para usar las funciones de éste módulo, el binario PHP debe ser compilado con la siguiente línea de configuración: --with-iconv[=DIR].

Note: Nota para Usuarios de Windows® Para habilitar éste módulo en un entorno Windows®, necesita colocar un archivo DLL llamado iconv.dll o iconv-1.3.dll (antes de 4.2.1), el cual hace parte del paquete binario PHP/Win32, en un directorio especificado por la variable de entorno PATH o uno de los directorios de sistema de su instalación de Windows®. Este módulo es parte de PHP a partir de PHP 5, por lo tanto iconv.dll y php_iconv.dll no se requieren más.

Configuración en tiempo de ejecución

El comportamiento de estas funciones está afectado por los valores definidos en php.ini.

Opciones de configuración de iconv
Nombre Predeterminado Modificable Cambios
iconv.input_encoding "ISO-8859-1" PHP_INI_ALL Disponible desde PHP 4.0.5.
iconv.output_encoding "ISO-8859-1" PHP_INI_ALL Disponible desde PHP 4.0.5.
iconv.internal_encoding "ISO-8859-1" PHP_INI_ALL Disponible desde PHP 4.0.5.
For further details and definitions of the PHP_INI_* constants, see the Directivas de php.ini.

Warning

Algunos sistemas (como IBM AIX) usan "ISO8859-1" en lugar de "ISO-8859-1", así que este valor debe usado en las opciones de configuración y en los parámetros de función.

Note: La opción de configuración iconv.input_encoding actualmente no es usada en absoluto.

Tipos de recursos

Esta extensión no tiene ningún tipo de recurso definido.

Constantes predefinidas

Desde PHP 4.3.0, es posible identificar, en tiempo de ejecución, qué implementación de iconv es adoptada por esta extensión.

Constantes de iconv
Nombre Tipo Descripción
ICONV_IMPL string El nombre de la implementación
ICONV_VERSION string La versión de la implementación

Note: Escribir scripts que dependan de la implementación con éstas constantes no se recomienda en absoluto.

A partir de PHP 5.0.0, las siguientes constantes se encuentran disponibles también:

Constantes de iconv disponibles desde PHP 5.0.0
Nombre Tipo Descripción
ICONV_MIME_DECODE_STRICT integer Una máscara de bits usada para iconv_mime_decode()
ICONV_MIME_DECODE_CONTINUE_ON_ERROR integer Una máscara de bits usada para iconv_mime_decode()

Ver también

Vea también las funciones GNU Recode.

Table of Contents


Referencia de funciones
PHP Manual