Delicious Bookmark this on Delicious Share on Facebook SlashdotSlashdot It! Digg! Digg



PHP : Function Reference : Apache-specific Functions : apache_child_terminate

apache_child_terminate

Terminate apache process after this request (PHP 4 >= 4.0.5, PHP 5)
bool apache_child_terminate ( )

apache_child_terminate() will register the Apache process executing the current PHP request for termination once execution of PHP code it is completed. It may be used to terminate a process after a script with high memory consumption has been run as memory will usually only be freed internally but not given back to the operating system.

Return Values

Returns TRUE if PHP is running as an Apache 1 module, the Apache version is non-multithreaded, and the child_terminate PHP directive is enabled (disabled by default). If these conditions are not met, FALSE is returned and an error of level E_WARNING is generated.

Notes

Note:

This function is not implemented on Windows platforms.

See Also
exit()

Code Examples / Notes » apache_child_terminate

daniele_dll

Don't use this function to simply terminate your scripts!
Using this function you will cause a BIG overhead to apache, infact it will terminate and restart child processes instead to execute more requests in the same process!
Use die or exit instead


sam

apache_child_terminate does NOT terminate the running script.
It terminates the apache process running the script AFTER it has finished running the script.
It has no side effects on page generation, you should only call it in cases where you know your script will have used a lot of memory and you want to give it back to the system.


anonymous

<?php
function term() {
if(function_exists('apache_child_terminate')) {
 apache_child_terminate();
}
die('Terminated');
}
?>
Also, when apache_child_terminate is called, it terminates the script, so die()/exit() is not necessary if the script is 100% sure to be on an apache 1.x server, else a die()/exit() is as good as it gets.
I found its a semi-good idea to terminate the child if available after critical low-level errors.


Change Language


Follow Navioo On Twitter
apache_child_terminate
apache_get_modules
apache_get_version
apache_getenv
apache_lookup_uri
apache_note
apache_request_headers
apache_reset_timeout
apache_response_headers
apache_setenv
ascii2ebcdic
ebcdic2ascii
getallheaders
virtual
eXTReMe Tracker