imap_mime_header_decode

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_mime_header_decode — Decodifica los elementos MIME de un encabezado

Descripción

imap_mime_header_decode(string $string): array|false

Decodifica un mensaje MIME que contiene datos no ASCII (ver » RFC2047).

Parámetros

string: El texto MIME

Valores devueltos

Los elementos decodificados se devuelven en un array de objetos. Cada uno de estos objetos tiene dos propiedades: charset y text.

Si el elemento no ha sido codificado, o, en otras palabras, si está en claro (plain US_ASCII), la propiedad charset se establece en default.

Esta función devuelve false en caso de fallo.

Ejemplos

Ejemplo #1 Ejemplo con imap_mime_header_decode()

<?php
$text = "=?ISO-8859-1?Q?Keld_J=F8rn_Simonsen?= <keld@example.com>";

$elements = imap_mime_header_decode($text);
for ($i=0; $i<count($elements); $i++) {
    echo "Charset : {$elements[$i]->charset}\n";
    echo "Texto : {$elements[$i]->text}\n\n";
}
?>

El ejemplo anterior mostrará:

Charset: ISO-8859-1
Texto: Keld Jørn Simonsen

Charset: default
Texto:  <keld@example.com>

En el ejemplo anterior, se encuentran dos elementos: el primero ha sido codificado en ISO-8859-1, y el segundo está en claro.

Ver también

imap_utf8() - Convierte texto en formato MIME a UTF-8

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

Anonymous ¶

12 years ago

A nice way to decode strings is to use the mb_list_encodings(), but I had two problems with it: 
sometimes, the charset is uppercase in the header an lowercase in mb_list_encodings() and sometimes, the charset is not in the mb_list_encodings() list.

<?php
function upperListEncode() { //convert mb_list_encodings() to uppercase
    $encodes=mb_list_encodings();
    foreach ($encodes as $encode) $tencode[]=strtoupper($encode);
    return $tencode;
    }

function decode($string) {
    $tabChaine=imap_mime_header_decode($string);
    $texte='';
    for ($i=0; $i<count($tabChaine); $i++) {
        
        switch (strtoupper($tabChaine[$i]->charset)) { //convert charset to uppercase
            case 'UTF-8': $texte.= $tabChaine[$i]->text; //utf8 is ok
                break;
            case 'DEFAULT': $texte.= $tabChaine[$i]->text; //no convert
                break;
            default: if (in_array(strtoupper($tabChaine[$i]->charset),upperListEncode())) //found in mb_list_encodings()
                        {$texte.= mb_convert_encoding($tabChaine[$i]->text,'UTF-8',$tabChaine[$i]->charset);}
                     else { //try to convert with iconv()
                          $ret = iconv($tabChaine[$i]->charset, "UTF-8", $tabChaine[$i]->text);    
                          if (!$ret) $texte.=$tabChaine[$i]->text;  //an error occurs (unknown charset) 
                          else $texte.=$ret;
                        }                    
                break;
            }
        }
        
    return $texte;    
    }
?>

＋add a note