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 */
?>