LX. Iconv
Introduzione
Questo modulo contiene un'interfaccia al tool di conversione dei caratteri iconv. Tramite questo modulo si può convertire una stringa dal set di caratteri locale ad un'altro. I set di caratteri supportati dipendono dalla implementazione di iconv installata. Occorre rilevare che le funzioni iconv, in alcuni sistemi, possono non fornire le risposte attese. In questi casi è una buona idea installarela libreria GNU libiconv, la quale fornisce risultati più consistenti.
Dalla versione 5.0.0 di PHP, questa versione viene rilasciata con diverse funzioni che aiutano a realizzare script in più lingue. Guardare nelle sezioni seguenti per scoprire queste nuove caratteristiche.
Requisiti
Non occorre nulla se il sistema che si sta utilizzando è un sistema recente compatibile POSIX, poichè le librerie C standard fornite con la macchina forniscono le funzioni iconv. Negli altri casi occorre installare sul sistema la libreria libiconv
Installazione
Per potere utilizzare le funzioni fornite da questo modulo, occorre compila il PHP con la seguente linea di configurazione: --with-iconv[=DIR].
Note per gli utenti Windows®: Per potere abilitare questo modulo nei sistemi Windows® occorre posizionare la DLL iconv.dll o iconv-1.3.dll (nelle versioni precedenti alla 4.2.1), rilasciata con il pacchetto PHP/Win32 nella directory indicata dalla variabile d'ambiente PATH oppure in una directory di installazione di Windows®.
Configurazione di Runtime
Il comportamento di queste funzioni è influenzato dalle impostazioni di php.ini.
Tabella 1. Parametri di configurazione di Iconv
| Nome | Default | Modificabile |
|---|---|---|
| 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 |
Tipi di risorse
Questa estensione non definisce alcun tipo di risorsa.
Costanti predefinite
Dalla versione 4.3.0 di PHP è possibile identificare da untime quale implementazione di iconv è adottata da questo modulo.
Tabella 2. Costanti iconv
| Nome | Tipo | Descrizione |
|---|---|---|
| ICONV_IMPL | string | Il nome dell'implementazione |
| ICONV_VERSION | string | Versione dell'implementazione |
Nota: La scrittura di codice che utilizzi tali costanti per identificare l'implementazione è scoraggiata.
Dalla versione 5.0.0 di PHP saranno disponibili le seguenti costanti:
Tabella 3. Costanti iconv dispèonibili da PHP 5.0.0
| Nome | Tipo | Descrizione |
|---|---|---|
| ICONV_MIME_DECODE_STRICT | integer | Maschera di bit utilizzata da iconv_mime_decode() |
| ICONV_MIME_DECODE_CONTINUE_ON_ERROR | integer | Maschera di bit utilizzata per iconv_mime_decode() |
Vedere anche:
Vedere anche GNU Recode.
- Sommario
- iconv_get_encoding -- Visualizza l'attuale impostazione per la conversione dei caratteri codificati
- 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 -- Setta l'attuale impostazione per la conversione dei caratteri codificati
- 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 -- Converte una stringa nel set di caratteri richiesto
- ob_iconv_handler -- Converte caratteri codificati come un output buffer handler