apache_child_terminate

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

apache_child_terminate — Termină (lichidează) procesul apache după această cerere

Descrierea

apache_child_terminate ( ) : bool

apache_child_terminate() va înregistra procesul Apache, ce execută interpelarea dată PHP, pentru a fi terminat (lichidat) odată cu finalizarea executării codului PHP. Această funcție poate fi utilizată pentru a termina un proces după rularea unui script cu un consum de memorie substanțial, deoarece memoria de obicei este eliberată intern și nu este întoarsă sistemului de operare.

Lucrează în Apache, FastCGI și modul NSAPI pe webservere Netscape/iPlanet/SunONE.

Valorile întoarse

Întoarce true dacă PHP rulează în calitate de modul Apache 1, Apache nu rulează pe mai multe fire de execuție și directiva PHP child_terminate este activată (ea este dezactivată implicit). Dacă aceste condiții nu sunt satisfăcute, este întors false și este generată o eroare de nivel E_WARNING.

Note

Notă: Această funcție nu este implementată pe platformele Windows.

A se vedea și

exit() - Output a message and terminate the current script

add a note

User Contributed Notes 5 notes

down

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' );



?>

down

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.

down

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.

down

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!

down

-1

admin at hostultra dot com ¶

17 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());
}
}

add a note