PHP Manual»Fonctions sur les chaînes de caractères multioctets»mb_encode_mimeheader

mb_encode_mimeheader

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_encode_mimeheader — Encode une chaîne pour un en-tête MIME

Description

function mb_encode_mimeheader(
    string $string,
    ?string $charset = null,
    ?string $transfer_encoding = null,
    string $newline = "\r\n",
    int $indent = 0
): string

Encode une string string donnée en un en-tête MIME.

Liste de paramètres

string: La string à encoder. Son encodage devrait être identique à mb_internal_encoding().
charset: charset est le nom de l'encodage utilisé par la chaîne string. La valeur par défaut est déterminée par les paramètres courants du NLS (mbstring.language).
transfer_encoding: transfer_encoding est l'encodage de transfert. Il peut être "B" (Base64) ou "Q" (Quoted-Printable). Par défaut, c'est "B".
newline: newline spécifie les fins de lignes (EOF : end-of-line) utilisées par mb_encode_mimeheader() pour formater la chaîne (une » RFC définie la longueur d'une chaîne à partir de laquelle on doit ajouter une fin de ligne. La longueur courante est 74 caractères). La valeur par défaut est "\r\n" (CRLF).
indent: Indentation de la première ligne (nombre de caractères dans l'en-tête avant string).

Valeurs de retour

Une version convertie de la string en ASCII.

Historique

Version	Description
8.3.0	Les octets `NUL` (0) ne sont plus supprimés lors de l'encodage en Quoted-Printable, mais encodés en `=00`.
8.0.0	`charset` et `transfer_encoding` sont désormais nullable.

Exemples

Exemple #1 Exemple avec mb_encode_mimeheader()

<?php
$name = "太郎"; // kanji
$mbox = "kru";
$doma = "gtinn.mon";
$addr = '"' . addcslashes(mb_encode_mimeheader($name, "UTF-7", "Q"), '"') . '" <' . $mbox . "@" . $doma . ">";
echo $addr;
?>

L'exemple ci-dessus va afficher :

"=?UTF-7?Q?+WSqQzg-?=" <kru@gtinn.mon>

Notes

Note:
Cette fonction n'est pas conçue pour couper les lignes en milieu de mots. Ce comportement peut ajouter des espaces non désirées dans un mot de la chaîne originale.

Voir aussi

mb_decode_mimeheader() - Décode un en-tête MIME