http_response_code

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

http_response_code — Récupère ou définit le code de réponse HTTP

Description

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

Récupère ou définit le code d'état de réponse HTTP.

Liste de paramètres

response_code: Le paramètre optionnel response_code définira le code de réponse.

Valeurs de retour

Si response_code est fourni, dans ce cas le code d'état précédent est retourné. Si response_code n'est pas fourni, alors le code d'état actuel est retourné. Ces deux valeurs sont par défaut le code d'état 200 si utilisé dans un environnement de serveur Web.

false est retourné si response_code n'est pas fourni et n'est pas invoqué dans un environnement de serveur Web (par exemple depuis une application CLI) true est retourné si response_code est fourni et n'est pas invoqué dans un environnement de serveur Web (mais uniquement si aucun état de réponse précédent n'a été défini).

Exemples

Exemple #1 Utiliser http_response_code() dans un environnement de serveur Web

<?php

// Récupérer le code actuel de réponse et définir un nouveau
var_dump(http_response_code(404));

// Récupérer le nouveau code de réponse
var_dump(http_response_code());
?>

L'exemple ci-dessus va afficher :

int(200)
int(404)

Exemple #2 Utiliser http_response_code() dans un environnement CLI

<?php

// Récupérer le code de réponse par défaut
var_dump(http_response_code());

// Définir un code de réponse
http_response_code(404);

// Récupérer le nouveau code de réponse
var_dump(http_response_code());
?>

L'exemple ci-dessus va afficher :

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

Voir aussi

header() - Envoie un en-tête HTTP brut
headers_list() - Retourne la liste des en-têtes de réponse du script courant