imap_mime_header_decode

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

imap_mime_header_decodeДекодирует элементы заголовка

Описание

imap_mime_header_decode(string $string): array|false

Декодирует MIME-расширения заголовка, не являющиеся текстом ASCII (подробнее — » RFC2047).

Список параметров

string

MIME-текст

Возвращаемые значения

Декодированные элементы возвращаются в массиве объектов, где каждый объект имеет два свойства, charset и text.

Если элемент не был декодирован, или, другими словами, он является текстом US-ASCII, свойство charset будет установлено в значение default.

Функция возвращает false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования 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
"Text: {$elements[$i]->text}\n\n";
}
?>

Результат выполнения приведённого примера:

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

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

В примере выше, мы получим два элемента, где первый элемент был ранее закодирован в ISO-8859-1, а второй US-ASCII.

Смотрите также

  • imap_utf8() - Преобразовывает MIME-кодированный текст в UTF-8

Добавить

Примечания пользователей 1 note

up
9
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.<?phpfunction 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;        }?>
To Top