apache_child_terminate

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

apache_child_terminateFinaliza o processo Apache depois da requisição

Descrição

apache_child_terminate ( ) : bool

A função apache_child_terminate() registrará para finalização o processo Apache executando a requisição atual do PHP quando a execução do código PHP terminar. Isto pode ser utilizado para terminar um processo depois que um script que tem um alto consumo de memória for rodado e quando essa memória normalmente só é liberada internamente, mas não é devolviva para o sistema operacional.

Valor Retornado

Retorna true se o PHP estiver rodando como um módulo Apache 1, a versão do Apahe não tem multithreaded, e a diretiva PHP child_terminate está ativa (desativada por padrão). Se essas condições não são alcançadas então false é retornado um erro E_WARNING é gerado.

Changelog

Versão Descrição
5.4.0 Esta funçõe se tornou disponível no FastCGI. Anteriormente ele só era suportado quando o PHP era instalado como módulo do Apache.

Notas

Nota: esta função não é implementada na plataforma Windows

Veja Também

  • exit() - Mostra uma mensagem e termina o script atual

add a note add a note

User Contributed Notes 4 notes

up
0
Stephan Ferraro
13 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
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
-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());
}
}
up
-2
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!
To Top