Filtros de Conversión

De forma similar a los filtros string.*, los filtros convert.* realizan acciones semejantes a sus nombres. Los filtros de conversión fueron agregados en PHP 5.0.0. Para más información sobre un filtro dado, refiérase a la página del manual sobre la función correspondiente.

convert.base64-encode y convert.base64-decode El uso de estos filtros es equivalente a procesar todos los datos de la secuencia a través de las funciones base64_encode() y base64_decode() respectivamente. convert.base64-encode soporta el uso de parámetros entregados como una matriz asociativa. Si se usa longitud-linea, la salida base64 será separada en paquetes de longitud-linea caracteres cada uno. Si se usa caracteres-final-de-linea, cada paquete será delimitado por los caracteres dados. Estos parámetros ofrecen el mismo efecto que usar base64_encode() con chunk_split().

Ejemplo #1 convert.base64-encode y convert.base64-decode


<?php
$da = fopen('php://output', 'w');
stream_filter_append($da, 'convert.base64-encode');
fwrite($da, "Esto es una prueba.\n");
fclose($da);
/* Imprime:  RXN0byBlcyB1bmEgcHJ1ZWJhLgo=  */

$param = array('line-length' => 8, 'line-break-chars' => "\r\n");
$da = fopen('php://output', 'w');
stream_filter_append($da, 'convert.base64-encode', STREAM_FILTER_WRITE, $param);
fwrite($da, "Esto es una prueba.\n");
fclose($da);
/* Imprime:  RXN0byBl
          :  cyB1bmEg
          :  cHJ1ZWJh
          :  Lgo=  */

$da = fopen('php://output', 'w');
stream_filter_append($da, 'convert.base64-decode');
fwrite($da, "RXN0byBlcyB1bmEgcHJ1ZWJhLgo=");
fclose($da);
/* Imprime:  Esto es una prueba.  */
?>

convert.quoted-printable-encode y convert.quoted-printable-decode El uso de la versión de docedificación de este filtro es equivalente a procesar todos los datos de la secuencia a través de la función quoted_printable_decode(). No existe una función equivalente a convert.quoted-printable-encode. convert.quoted-printable-encode soporta el uso de parámetros dados como una matriz asociativa. Adicionalmente a los parámetros soportados por convert.base64-encode, convert.quoted-printable-encode soporta también los argumentos booleanos binary y force-encode-first. convert.base64-decode soporta únicamente el parámetro line-break-chars como una sugerencia del tipo para eliminar del material codificado.

Ejemplo #2 convert.quoted-printable-encode y convert.quoted-printable-decode


<?php
$da = fopen('php://output', 'w');
stream_filter_append($da, 'convert.quoted-printable-encode');
fwrite($da, "Esto es una prueba.\n");
/* Imprime:  =Esto es una prueba.=0A  */
?>