apache_child_terminate

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

apache_child_terminate — Завершить процесс Apache по окончании текущего запроса

Описание

bool apache_child_terminate ( void )

apache_child_terminate() регистрирует процесс Apache, обслуживающий текущий запрос PHP с тем, чтобы завершить его по окончании выполнения PHP скрипта. Эта функция может быть использована для завершения процесса, для работы которого понадобилось значительное количество оперативной памяти, не возвращенной операционной системе по завершении работы PHP скрипта.

Возвращаемые значения

Возвращает TRUE, если PHP работает в качестве Apache 1 модуля, версия Apache не является многопоточной и параметр конфигурации PHP child_terminate включен (по умолчанию выключен). В противном случае функция возвратит FALSE и сгенерирует ошибку уровня E_WARNING.

Список изменений

Версия	Описание
5.4.0	Эта функция стала доступной в режиме FastCGI. Ранее она поддерживалась только при запуске PHP в качестве модуля для Apache.

Примечания

Замечание: Для Windows-платформ эта функция не реализована.

Смотрите также

exit() - Выводит сообщение и прекращает выполнение текущего скрипта

add a note

User Contributed Notes 4 notes

down

Stephan Ferraro ¶

6 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

louis at ewens dot com ¶

8 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

admin at hostultra dot com ¶

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

down

-1

daniele_dll at yahoo dot it ¶

9 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!

add a note