CVI. Funciones de Control de Salida

IntroducciÃ³n

Las funciones de Control de Salida le permiten controlar cuÃ¡ndo es enviada la salida desde el script. Esto puede resultar Ãºtil en muchas situaciones diferentes, especialmente si necesita enviar cabeceras al navegador despuÃ©s de que su script ha comenzado a enviar datos. Las funciones de Control de Salida no afectan las cabeceras enviadas usando header() o setcookie(), sÃ³lo funciones como echo() y los datos entre bloques de cÃ³digo PHP.

Requisitos

No se necesitan bibliotecas externas para construir esta extensiÃ³n

InstalaciÃ³n

No se necesita ninguna instalaciÃ³n para usar estas funciones, son parte del nÃºcleo de PHP.

ConfiguraciÃ³n en tiempo de ejecuciÃ³n

El comportamiento de estas funciones estÃ¡ afectado por los valores definidos en php.ini.

Tabla 1. Opciones de configuraciÃ³n del Control de Salida

Nombre	Predeterminado	Modificable	Cambios
output_buffering	"0"	PHP_INI_PERDIR
output_handler	NULL	PHP_INI_PERDIR	Disponible desde PHP 4.0.4.
implicit_flush	"0"	PHP_INI_ALL	PHP_INI_PERDIR en PHP <= 4.2.3.

For further details and definitions of the PHP_INI_* constants, see the ApÃ©ndice G.

A continuaciÃ³n se presenta una corta explicaciÃ³n de las directivas de configuraciÃ³n.

output_buffering boolean/integer

Puede habilitar el uso de bÃºferes de salida para todos los archivos, definiendo esta directiva como 'On'. Si desea limitar el tamaÃ±o del bÃºfer a cierta cantidad - puede usar un nÃºmero mÃ¡ximo de bytes, en lugar de 'On', como valor para esta directiva (p.ej., output_buffering=4096). A partir de PHP 4.3.5, esta directiva siempre tiene el valor Off en PHP-CLI.

output_handler string

Puede redireccionar toda la salida de sus scripts a una funciÃ³n. Por ejemplo, si establece el valor de output_handler a mb_output_handler(), la codificaciÃ³n de caracteres serÃ¡ convertida de forma transparente a la codificaciÃ³n especificada. Al definir cualquier gestor de salida, el control mediante bÃºferes se activa automÃ¡ticamente.

Nota: Usted no puede usar mb_output_handler() con ob_iconv_handler() al tiempo, y no puede usar ob_gzhandler() y zlib.output_compression al tiempo.

Nota: Solo funciones integradas del lenguaje pueden ser usadas con esta directiva. Para funciones definidas por el usuario, use ob_start().

implicit_flush boolean

FALSE por defecto. Cambiar este valor a TRUE le indica a PHP que debe decirle a la capa de salida que se vacÃe automÃ¡ticamente despuÃ©s de cada bloque de salida. Esto es equivalente a llamar la funciÃ³n de PHP flush() despuÃ©s de todas y cada una de las llamadas a print() o echo(), y cada bloque HTML.

Cuando use PHP bajo un entorno web, el habilitar esta opciÃ³n tiene unas implicaciones serias en el rendimiento, y por lo general se recomienda su uso Ãºnicamente para propÃ³sitos de depuraciÃ³n. Este valor es igual a TRUE por defecto cuando se opera bajo la SAPI CLI.

Vea tambiÃ©n ob_implicit_flush().

Tipos de recursos

Esta extensiÃ³n no tiene ningÃºn tipo de recurso definido.

Constantes predefinidas

Esta extensiÃ³n no tiene ninguna constante definida.

Ejemplos

Ejemplo 1. Ejemplo de Control de Salida

<?php ob_start(); echo "Hola\n"; setcookie("nombre_cookie", "datos_cookie"); ob_end_flush(); ?>

En el anterior ejemplo, la salida de echo() serÃa almacenada en el bÃºfer de salida hasta que ob_end_flush() sea llamada. Entre tanto, la llamada a setcookie() almacena satisfactoriamente una cookie sin causar un error. (Normalmente, usted no puede enviar cabeceras al navegador despuÃ©s de que se han enviado datos.)

Nota: Cuando se actualice desde PHP 4.1 (y 4.2) hacia 4.3, debe asegurarse de que implict_flush tenga el valor OFF en su php.ini debido a un fallo en versiones antiguas, de otra forma, cualquier salida procesada por ob_start() no serÃ¡ ocultada en la salida final.

Ver tambiÃ©n

Vea tambiÃ©n header() y setcookie().

Tabla de contenidos
flush -- Vaciar el bÃºfer de salida
ob_clean -- Limpiar (eliminar) el bÃºfer de salida
ob_end_clean -- Limpiar (eliminar) y deshabilitar los bÃºferes de salida
ob_end_flush -- Volcar (enviar) el bÃºfer de salida y deshabilitar el uso del bÃºfer
ob_flush -- Vaciar (enviar) el bÃºfer de salida
ob_get_clean -- Obtener los contenidos del bÃºfer actual y eliminar el bÃºfer de salida actual
ob_get_contents -- Devolver el contenido del bÃºfer de salida
ob_get_flush -- Volcar el bÃºfer de salida, devolverlo como una cadena y deshabilitar el uso de bÃºferes de salida
ob_get_length -- Devolver la longitud del bÃºfer de salida
ob_get_level -- Devolver el nivel de anidamiento del mecanismo de bÃºferes de salida
ob_get_status -- Obtener el status de los bÃºferes de salida
ob_gzhandler -- Llamada de retorno de ob_start para comprimir mediante gzip el bÃºfer de salida
ob_implicit_flush -- Habilitar/deshabilitar el volcado implÃcito
ob_list_handlers -- Listar todos los gestores de salida en uso
ob_start -- Habilitar el uso de bÃºferes de salida
output_add_rewrite_var -- Agregar valores de re-escritura de URL
output_reset_rewrite_vars -- Reestablecer los valores del mecanismo de re-escritura de URLs

add a note User Contributed Notes
Funciones de Control de Salida

kamermans at teratechnologies dot net
21-Aug-2006 01:30


Output buffering is set to '4096' instead of 'Off' or '0' by default in the php-5.0.4-10.5 RPM for Fedora Core release 4 (Stentz).  This has cost me much time!

webmaster [at] oltec-solutions [dot] nl
10-Jul-2006 06:00


In re to erwinX at darwineX dot nl:



Adding an ampersand (&) before the hash seems to work too (for me at least), i.e.: http://somedomain.tld/blah.php?arg=x&#something



I guess php then interperts it as an argument to the script. Might save some time and resources.

erwinX at darwineX dot nl
11-Nov-2005 05:35


[Concerns IE refusing to jump to a #something in the URL.]



I encoutered a bug in IE6/W2000 that can be solved by turning output buffering on.

Maybe it also helps in other situations/M$-OS, not sure.



Situation:

A page with a hash in the URL, and IE doesn't jump to that location.



Example:

http://www.bla.com/test.php#something



- In test.php the anchortag is placed normally like:

<a name="something"><br></a>



- test.php takes a few seconds to load because of heavy-duty database activity.



IE just ignores the hash #something.



It looks like IE 'forgets' the hash if it hasn't encoutered it YET in the HTML.



Turning output buffering on resolves that issue.

kend52 at verizon dot net
23-Jun-2005 11:25


I ran out of memory, while output buffering and drawing text on imported images. Only the top portion of the 5MP image was displayed by the browser.  Try increasing the memory limit in either the php.ini file( memory_limit = 16M; ) or in the .htaccess file( php_value memory_limit "16M" ). Also see function memory_get_usage() .

gruik at libertysurf dot fr
10-Jul-2004 05:53


For those who are looking for optimization, try using buffered output.



I noticed that an output function call (i.e echo()) is somehow time expensive. When using buffered output, only one output function call is made and it seems to be much faster.

Try this :



<?php

your_benchmark_start_function();



for ($i = 0; $i < 5000; $i++)

    echo str_repeat ("your string blablabla bla bla", (rand() % 4) + 1)."<br>\n";



echo your_benchmark_end_function();

?>



And then :



<?php

your_benchmark_start_function();



ob_start ();

for ($i = 0; $i < 5000; $i++)

    echo str_repeat ("your string blablabla bla bla", (rand() % 4) + 1)."<br>\n";



echo your_benchmark_end_function();

ob_end_flush ();

?>

nobbie @t php d0t net
01-Apr-2004 04:49


There is a problem in MSIE 5.5,6 with regards to Page compression. Users might experience pages not loading completely, or just a blank page.



This articles you are looking for is what you're looking for:

 Microsoft Knowledge Base Article - 312496 (for MSIE 6)

 Microsoft Knowledge Base Article - 313712 (for MSIE 5.5)



It states that you should upgrade to the latest MSIE Service Pack to fix the following problem:



Internet Explorer May Lose the First 2,048 Bytes of Data That Are Sent Back from a Web Server That Uses HTTP Compression

tijmen
09-Jul-2003 04:44


Trying to benchmark your server when using output_buffering ?

Don't forget that the value 4096 in the php.ini will give you complete different loadtimes compares to the value of 1.

In the first case the output will be sent after buffering 4096 and the loadtime timed at the end of the page will contain the loadtime needed to download the complete page in the clientbrowser while the second value will contain the loadtime needed to place the complete page in the buffer. The time needed for sending is not clocked.

This can be very frustrating if you don't see the differance between server and the 1st is using 4096 instead of 1.

Although technically much faster than the second server the second server was providing much better loadtime results.

This result will grow when using large amounts of output.

But this becomes interesting if you want to measure the time needed for the page to be loaded for the client.

philip at thepr()jects dot ()rg
08-Feb-2001 11:17


A few tutorials exist on this subject :





* http://www.zend.com/zend/art/buffering.php


* http://www.phpbuilder.com/columns/argerich20010125.php3

add a note