http_response_code

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

http_response_codeRé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 fournit, dans ce cas là le code d'état précédent sera retourné. Si response_code n'est pas fournit, alors le code d'état actuel sera retourné. Ces deux valeurs seront par défaut le code d'état 200 si utilisé dans un environnement de serveur Web.

false sera retourné si response_code n'est pas fournit et n'est pas invoqué dans un environnement de serveur Web (par exemple depuis une application CLI) true sera retourné si response_code est fournit 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