Filtres de conversion

Comme pour les filtres de chaînes, les filtres de conversion font ce que leur nom indique. Ces filtres ont été ajoutés en PHP 5.0.0. Pour plus d'informations, voyez le manuel de la fonction correspondante.

convert.base64-encode et convert.base64-decode Utilisez ce filtre pour faire traiter les données par les fonctions base64_encode() et base64_decode(). convert.base64-encode supporte les paramètres sous forme de tableau. Si line-length est donné, le résultat sera coupé en lignes de line-length caractères. Si line-break-chars est founi, chaque bloc de caractères sera terminé par ce paramètre. Ces paramètres donnent le même effet que la fonction base64_encode() utilisée conjointement avec chunk_split().

Exemple #1 Exemple avec les filtres convert.base64-encode et convert.base64-decode


<?php
$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'convert.base64-encode');
fwrite($fp, "This is a test.\n");
fclose($fp);
/* affiche :  VGhpcyBpcyBhIHRlc3QuCg==  */

$param = array('line-length' => 8, 'line-break-chars' => "\r\n");
$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'convert.base64-encode', STREAM_FILTER_WRITE, $param);
fwrite($fp, "This is a test.\n");
fclose($fp);
/* affiche :  VGhpcyBp
           :  cyBhIHRl
           :  c3QuCg==  */

$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'convert.base64-decode');
fwrite($fp, "VGhpcyBpcyBhIHRlc3QuCg==");
fclose($fp);
/* affiche :  This is a test.  */
?>

convert.quoted-printable-encode et convert.quoted-printable-decode Utilisez ce filtre pour faire traiter les données par la fonction quoted_printable_decode(). Il n'y a pas d'équivalent fonctionnel à convert.quoted-printable-encode. convert.quoted-printable-encode reçoit les paramètres sous forme de tableau. En plus des paramètres classiques de convert.base64-encode, convert.quoted-printable-encode accepte aussi les arguments booléens binary et force-encode-first. convert.base64-decode ne supporte le paramètre line-break-chars que comme indication pour supprimer les nouvelles lignes.

Exemple #2 Exemple avec les filtres convert.quoted-printable-encode et convert.quoted-printable-decode


<?php
$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'convert.quoted-printable-encode');
fwrite($fp, "This is a test.\n");
/* affiche :  =This is a test.=0A  */
?>

Les filtres convert.iconv.* sont disponible, si le support de iconv est activé, et leurs usages est équivalent à procéder tous les stream de données avec iconv(). Ces filtres ne supportent pas les paramètres, par contre ils attendent que le nom du filtre contienne l'encodage des données en saisie et de sortie, par exemple convert.iconv.<input-encoding>.<output-encoding> ou convert.iconv.<input-encoding>/<output-encoding> (les deux notations sont sémentiquement équivalente).

Exemple #3 convert.iconv.*


<?php
$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'convert.iconv.utf-16le.utf-8');
fwrite($fp, "T\0h\0i\0s\0 \0i\0s\0 \0a\0 \0t\0e\0s\0t\0.\0\n\0");
fclose($fp);
/* Outputs: This is a test. */
?>