http_response_code

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

http_response_codeObtiene o define el código de respuesta HTTP

Descripción

http_response_code(int $response_code = 0): int|bool

Obtiene o define el código de estado de respuesta HTTP.

Parámetros

response_code

El argumento opcional response_code definirá el código de respuesta.

Valores devueltos

Si response_code es proporcionado, en ese caso el código de estado anterior será devuelto. Si response_code no es proporcionado, entonces el código de estado actual será devuelto. Ambos valores serán por omisión el código de estado 200 si se utiliza en un entorno de servidor web.

false será devuelto si response_code no es proporcionado y no es invocado en un entorno de servidor web (por ejemplo desde una aplicación CLI) true será devuelto si response_code es proporcionado y no es invocado en un entorno de servidor web (pero únicamente si ningún estado de respuesta anterior ha sido definido).

Ejemplos

Ejemplo #1 Utilizar http_response_code() en un entorno de servidor web

<?php

// Obtener el código de respuesta actual y definir uno nuevo
var_dump(http_response_code(404));

// Obtener el nuevo código de respuesta
var_dump(http_response_code());
?>

El resultado del ejemplo sería:

int(200)
int(404)

Ejemplo #2 Utilizar http_response_code() en un entorno CLI

<?php

// Obtener el código de respuesta por omisión
var_dump(http_response_code());

// Definir un código de respuesta
http_response_code(404);

// Obtener el nuevo código de respuesta
var_dump(http_response_code());
?>

El resultado del ejemplo sería:

bool(false)
bool(true)
int(201)

Ver también

  • header() - Envía un encabezado HTTP bruto
  • headers_list() - Devuelve la lista de los encabezados de respuesta del script actual