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