PHP 8.4.22 Released!

header_remove

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

header_removeElimina un encabezado HTTP

Descripción

function 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 5 notes

up
15
Saeed Khamseh
15 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
10 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
2 years 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
0
razvan_bc at yahoo dot com
5 days ago
<?php
header_remove('Server');
phpinfo();
?>
In Apache php 8.5.6 it will only delete in the HTTP Headers Information section but the header is sent by Apache and cannot be override by php.
You can find it in the browser console, in the network section.
So you will need other various methods..
https://stackoverflow.com/questions/9000853/apache-how-to-hide-server-version-and-operation-system-from-users
up
-2
jake at qzdesign dot co dot uk
8 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