register_shutdown_function

register_shutdown_function

(PHP 3 >= 3.0.4, PHP 4, PHP 5)

register_shutdown_function --  Registrar una funci贸n para su ejecuci贸n al finalizar

Descripci贸n

void register_shutdown_function ( callback funcion [, mixed parametro [, mixed ...]] )

Registra la funci贸n de nombre funcion para ser ejecutada cuando el procesamiento del script se haya completado.

Es posible realizar m煤ltiples llamadas a register_shutdown_function(), y cada funci贸n ser谩 llamada en el mismo orden en el que son registradas. Si llama exit() al interior de una de las funciones de finalizaci贸n registradas, el procesamiento se detendr谩 por completo y ninguna otra funci贸n de finalizaci贸n ser谩 llamada.

En PHP 4.0.6 y versiones anteriores, bajo Apache, las funciones de finalizaci贸n registradas son llamadas despu茅s de que la petici贸n se ha completado (incluyendo el env铆o de todos los b煤feres de salida), as铆 que es imposible enviar salida al navegador usando echo() o print(), o recuperar los contenidos de cualquiera de los b煤feres de salida usando ob_get_contents(). A partir de PHP 4.1, las funciones de finalizaci贸n son llamadas como parte de la petici贸n, as铆 que es posible enviar la salida de ellas. Actualmente no hay forma de procesar los datos con las funciones de b煤feres de salida en la funci贸n de finalizaci贸n. La funci贸n de finalizaci贸n es llamada despu茅s de cerrar todos los b煤feres de salida abiertos, por lo tanto, por ejemplo, su salida no ser谩 comprimida si se habilita zlib.output_compression.

A partir de PHP 4, es posible pasar par谩metros a la funci贸n de finalizaci贸n pasando par谩metros adicionales a register_shutdown_function().

Nota: Usualmente las funciones indefinidas causan errores fatales en PHP, pero cuando la funcion llamada con register_shutdown_function() es indefinida, un error de nivel E_WARNING es generado en su lugar. Asimismo, por razones internas de PHP, este error har谩 referencia a Unknown en la l铆nea #0.

Nota: El directorio de trabajo del script puede cambiarse al interior de la funci贸n de finalizaci贸n bajo ciertos servidores web, p.ej. Apache.

Nota: La funci贸n de finalizaci贸n es llamada durante el cierre del script, as铆 que las cabeceras siempre habr谩n sido enviadas para entonces.

Vea tambi茅n auto_append_file, exit(), y la secci贸n sobre manejo de conexiones.