PHP 8.4.0 RC4 available for testing

apache_child_terminate

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

apache_child_terminateFinaliza un proceso de Apache después de esta llamada

Descripción

apache_child_terminate(): bool

apache_child_terminate() registrará el proceso Apache que esté ejecutando el requerimiento PHP actual para su finalización una vez que la ejecución del código haya finalizado. Puede ser utilizado para finalizar un proceso una vez que un script con un alto consumo de memoria haya sido ejecutado, dado que la memoria únicamente será liberada de forma interna, pero no será devuelta al sistema operativo.

Valores devueltos

Devuelve true si PHP está corriendo como módulo de Apache 1, la versión de Apache no es multi-hilo, y la directiva de PHP child_terminate está activada (desactivada por defecto). Si estas condiciones no se cumplen, se devuelve false y se genera un error de nivel E_WARNING.

Historial de cambios

Versión Descripción
5.4.0 Esta función está disponible bajo FastCGI. Anteriormente, estaba soportada solo cuando había sido instalado un módulo PHP en Apache.

Notas

Nota: Esta función no está implementada en plataformas Windows.

Ver también

  • exit() - Imprime un mensaje y termina el script actual

add a note

User Contributed Notes 5 notes

up
1
Stephan Ferraro
14 years ago
I found out a solution for Apache 2. However this works only without threads and only on POSIX compatible OS systems (e.g. Linux, OpenSolaris...).

<?php

// Terminate Apache 2 child process after request has been
// done by sending a SIGWINCH POSIX signal (28).
function kill_on_exit() {
posix_kill( getmypid(), 28 );
}

register_shutdown_function( 'kill_on_exit' );

?>
up
1
jasonlester at nope dot com
1 year ago
On FastCGI SAPIs this doesn't kill the process, it just makes the fastcgi handler fully recycle PHP at the end of the script rather than just recycling the request state. This includes php-cgi.
up
0
louis at ewens dot com
16 years ago
Apache child processes are greedy. If they get bloated by a PHP application that requires a lot of memory, they stay that way. The memory is never given back to the OS until that child dies.

You could use MaxRequestsPerChild in Apache to kill all child processes automatically after a certain number of connections. Or you can use apache_child_terminate to kill the child after your memory intensive functions.

Note: apache_child_terminate is not available in Apache 2.0 handler.
up
0
daniele_dll at yahoo dot it
16 years ago
In response to sam at liddicott dot com:

it isin't so simple! You should never kill an apache process because it is automatically freed when apache need!

And, if you use apache worker or thread based mpm you risk to kill the entire process!

result: DO NOT USE THIS FUNCTION!
up
-1
admin at hostultra dot com
16 years ago
this code will add apache_child_terminate() function if it is not already present.

if (!function_exists("apache_child_terminate")){
function apache_child_terminate(){
register_shutdown_function("killonexit");
}

function killonexit(){
@exec("kill ".getmypid());
}
}
To Top