header_remove

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

header_removeElimina un encabezado HTTP

Descripción

header_remove(?string $name = null): void

Elimina un encabezado HTTP previamente añadido con header().

Parámetros

name

El nombre del encabezado a eliminar. Si es null, todos los encabezados definidos previamente son eliminados.

Nota: Este argumento no distingue entre mayúsculas y minúsculas.

Valores devueltos

No se retorna ningún valor.

Historial de cambios

Versión Descripción
8.0.0 name ahora es nullable.

Ejemplos

Ejemplo #1 Eliminar un encabezado HTTP con header_remove()

<?php
header
("X-Foo: Bar");
header("X-Bar: Baz");
header_remove("X-Foo");
?>

Resultado del ejemplo anterior es similar a :

X-Bar: Baz

Ejemplo #2 Eliminar todos los encabezados HTTP con header_remove()

<?php
header
("X-Foo: Bar");
header("X-Bar: Baz");
header_remove();
?>

Resultado del ejemplo anterior es similar a :


Notas

Precaución

Esta función elimina todos los encabezados configurados por PHP, incluyendo cookies, sesiones y los encabezados X-Powered-By.

Nota:

Los encabezados solo serán accesibles y se mostrarán cuando se utilice un SAPI que los soporte.

Ver también

  • header() - Envía un encabezado HTTP bruto
  • headers_sent() - Indica si los encabezados HTTP ya han sido enviados

add a note

User Contributed Notes 4 notes

up
14
Saeed Khamseh
14 years ago
if you want to remove header information about php version (x-powered-by), you can use:

header_remove('x-powered-by');

alternatively, if you don't have php 5.3 installed, you can do the same thing using "header" command:

header('x-powered-by:');

don't forget the ':' character at the end of the string!
up
3
Anonymous
9 years ago
expose_php is php.ini only!

this won't work:
ini_set('expose_php',0);

works:
header_remove('x-powered-by');
up
1
luis dot angelino at laweb dot com dot br
1 year ago
If you are using this:

#!/usr/local/bin/php

You can add "-q" at the end of it and the headers will be removed, beacuse header_remove will not remove "Content-type"

#!/usr/local/bin/php -q
up
-2
jake at qzdesign dot co dot uk
7 years ago
When called from a command-line process, this function does nothing when passed a specific header to remove, but it does nonetheless work properly when called with no arguments to remove all headers.

Thus, when unit-testing or executing in some other test harness, if the code you are testing may call `header_remove()`, with the UOPZ and XDebug extensions loaded, you could use the following in order to more effectively test that the expected headers are set [which you would do by inspecting the array returned by `xdebug_get_headers()` after running the code under test, as `headers_list()` does not work despite the headers actually being stored internally as normal]:

<?php
uopz_set_return
(
'header_remove',
function(
$name = null) {
if (
$name !== null) {
$pattern = '/^' . preg_quote($name, '/') . ':/i';
$headers = array_filter(
xdebug_get_headers(),
function(
$header) use($pattern) {
return !
preg_match($pattern, $header);
}
);
}
// This works to remove all headers, just not individual headers.
header_remove();
if (
$name !== null) {
foreach (
$headers as $header) {
header($header);
}
}
},
true
);
?>
To Top