(PHP 5, PHP 7)
iconv_mime_encode — Construit un en-tête MIME avec les champs field_name et field_value
$field_name
, string $field_value
[, array $preferences = NULL
] )iconv_mime_encode() compose et retourne une chaîne de caractères qui représente un champ en-tête MIME qui ressemble à :
Subject: =?ISO-8859-1?Q?Pr=FCfung_f=FCr?= Entwerfen von einer MIME kopfzeile
field_nameLe nom du champ.
field_valueLa valeur du champs.
preferences
Vous pouvez contrôler le comportement de la fonction
iconv_mime_encode() en spécifiant
un tableau associatif contenant la configuration des
éléments dans le paramètre preferences.
La liste des éléments supportés par
iconv_mime_encode() figure ci-dessous.
Notez que les noms des éléments sont sensibles à la casse.
| Élément | Type | Description | Valeur par défaut | Exemple |
|---|---|---|---|---|
| scheme | string | Spécifie la méthode d'encodage d'un champ. Les valeurs possibles sont "B" ou "Q", où "B" signifie que le schéma d'encodage sera base64 et "Q", quoted-printable. | B | B |
| input-charset | string |
Spécifie le jeux de caractères pour représenter le premier paramètre
field_name et le second paramètre
field_value. S'il est omis,
iconv_mime_encode()
utilisera la directive de configuration
iconv.internal_encoding
de votre php.ini pour les représenter.
|
iconv.internal_encoding | ISO-8859-1 |
| output-charset | string | Spécifie le jeux de caractères à utiliser pour composer l'en-tête MIME. | iconv.internal_encoding | UTF-8 |
| line-length | integer | Spécifie la longueur maximale de chaque en-tête. Si l'en-tête est plus grande que la longueur défini par ce paramètre, l'en-tête résultant sera un en-tête composée de plusieurs lignes conformément au standard » RFC2822 - Internet Message Format. S'il est omis, la longueur maximale sera fixée à 76 caractères. | 76 | 996 |
| line-break-chars | string | Spécifie les caractères de fin de ligne. S'il est omis, la valeur par défaut sera "\r\n" (CR LF). Notez que ce paramètre est toujours représenté comme une chaîne ASCII au regard de la valeur du paramètre input-charset. | \r\n | \n |
Retourne un champs MIME en cas de succès,
ou FALSE si une erreur survient durant l'encodage.
Exemple #1 Exemple avec iconv_mime_encode()
<?php
$preferences = array(
"input-charset" => "ISO-8859-1",
"output-charset" => "UTF-8",
"line-length" => 76,
"line-break-chars" => "\n"
);
$preferences["scheme"] = "Q";
// This yields "Subject: =?UTF-8?Q?Pr=C3=BCfung=20Pr=C3=BCfung?="
echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences);
$preferences["scheme"] = "B";
// This yields "Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?="
echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences);
?>