http_response_code

(PHP 5 >= 5.4.0, PHP 7)

http_response_code — Obtener u establecer el código de respuesta HTTP

Descripción

http_response_code ([ int $response_code ] ) : mixed

Obtener u establecer el código de estado de la respuesta HTTP.

Parámetros

response_code: El parámetro opcional response_code establecerá el código de respuesta.

Valores devueltos

Si se proporciona response_code, se devolverá el código de estado anterior. Si no se proporciona response_code, se devolverá el código de estado actual. El valor predeterminado de estos dos valores será un código de estado 200 si se emplea en un entorno de servidor web.

Se devolverá FALSE si response_code no se proporciona y no se invoca en un entorno de servidor web (tal como desde una aplicación CLI). Se devolverá TRUE si se proporciona response_code y no se invoca en un entorno de servidor web (aunque solamente cuando no haya sido establecido ningún estado de respuesta anterior).

Ejemplos

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


<?php

// Obtener el código de la respuesta actual y establecer 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 Empleo de http_response_code() en un entorno CLI


<?php

// Obtener el código de respuesta predeterminado actual
var_dump(http_response_code());

// Establece un código de respuesta
var_dump(http_response_code(201));

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

El resultado del ejemplo sería:

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

Ver también

header() - Enviar encabezado sin formato HTTP
headers_list() - Devuelve una lista de encabezados de respuesta enviados (o listos para enviar)