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.
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.
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].
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.
El comportamiento de estas funciones est谩 afectado por los valores definidos en php.ini.
Tabla 1. 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. |
| Aviso |
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. |
Nota: La opci贸n de configuraci贸n iconv.input_encoding actualmente no es usada en absoluto.
Esta extensi贸n no tiene ning煤n tipo de recurso definido.
Desde PHP 4.3.0, es posible identificar, en tiempo de ejecuci贸n, qu茅 implementaci贸n de iconv es adoptada por esta extensi贸n.
Tabla 2. 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 |
Nota: 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:
Tabla 3. 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() |
Vea tambi茅n las funciones GNU Recode.