register_shutdown_function

Descripción

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().

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