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.
| 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. |
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.
| 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:
| 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
- iconv_get_encoding — Retrieve internal configuration variables of iconv extension
- iconv_mime_decode_headers — Decodes multiple MIME header fields at once
- iconv_mime_decode — Decodes a MIME header field
- iconv_mime_encode — Composes a MIME header field
- iconv_set_encoding — Set current setting for character encoding conversion
- iconv_strlen — Returns the character count of string
- iconv_strpos — Finds position of first occurrence of a needle within a haystack
- iconv_strrpos — Finds the last occurrence of a needle within a haystack
- iconv_substr — Cut out part of a string
- iconv — Convert string to requested character encoding
- ob_iconv_handler — Convert character encoding as output buffer handler