(PHP 5 >= 5.4.0, PHP 7, PHP 8)
header_register_callback — Chama uma função de cabeçalho
Registra uma função que será chamada quando o PHP começar a enviar a saída.
A função callback é executada logo após o PHP preparar todos
os cabeçalhos a serem enviados, e antes de qualquer outra saída ser enviada, criando uma janela
para manipular os cabeçalhos de saída antes de serem enviados.
As funções de retorno não são empilhadas. Chamadas subsequentes a header_register_callback()
vão desregistrar silenciosamente qualquer callback existente, independente de onde
ela foi definida. Esteja ciente que dependências podem sobrescrever a função de retorno.
A depuração de erros neste cenário pode ser difícil.
callbackFunção de retorno chamada logo antes dos cabeçalhos serem enviados. Não recebe parâmetros e o valor de retorno é ignorado.
Exemplo #1 Exemplo de header_register_callback()
<?php
header('Content-Type: text/plain');
header('X-Test: foo');
function foo() {
foreach (headers_list() as $header) {
if (strpos($header, 'X-Powered-By:') !== false) {
header_remove('X-Powered-By');
}
header_remove('X-Test');
}
}
$result = header_register_callback('foo');
echo "a";
?>O exemplo acima produzirá algo semelhante a:
Content-Type: text/plain a
header_register_callback() é executado quando os cabeçalhos estão prestes a ser enviados, portanto, qualquer saída desta função pode quebrar a saída.
Nota:
Os cabeçalhos só serão acessíveis e enviados quando uma SAPI que os suporta estiver em uso.