Fonctions PHP setcookie()Functions
Manuel de référence complet PHP HTTP
Définition et utilisation
La fonction setcookie() envoie un cookie HTTP au client.
Un cookie est une variable envoyée du serveur au navigateur. Un cookie est généralement un petit fichier texte que le serveur intègre sur l'ordinateur de l'utilisateur. Ce cookie est envoyé chaque fois que le même ordinateur demande une page via un navigateur.
Un cookie se voit automatiquement attribuer une variable portant le même nom. Par exemple, si un cookie nommé "user" est envoyé, une variable nommée $user est automatiquement créée et contient la valeur du cookie.
Le cookie doit être défini avant que toute autre sortie ne soit envoyée au client.
Retourne TRUE en cas de succès, ou FALSE en cas d'échec.
Syntaxe
| Parameters | Description |
|---|---|
| name | Requis. Spécifie le nom du cookie. |
| value | Requis. Spécifie la valeur du cookie. |
| expire | Facultatif. Spécifie le moment d'expiration du cookie. time()+3600*24*30 définira le cookie pour qu'il expire dans 30 jours. Si ce paramètre n'est pas défini, le cookie expirera automatiquement à la fin de la session (c'est-à-dire lorsque le navigateur est fermé). |
| path | Facultatif. Spécifie le chemin serveur du cookie. Si le chemin est défini sur "/", le cookie sera valide dans tout le domaine. Si le chemin est défini sur "/test/", le cookie sera valide dans le répertoire test et tous ses sous-répertoires. La valeur de chemin par défaut est le répertoire actuel où se trouve le cookie. |
| domain | Facultatif. Spécifie le domaine du cookie. Pour que le cookie soit valide dans tous les sous-domaines de example.com, vous devez définir le domaine du cookie sur ".example.com". Lorsque vous définissez le domaine du cookie sur www.example.com, le cookie n'est valide que dans le sous-domaine www. |
| secure | Facultatif. Spécifie si une connexion HTTPS sécurisée est requise pour transmettre le cookie. Définissez sur TRUE si le cookie doit être transmis via une connexion HTTPS sécurisée. La valeur par défaut est FALSE. |
Conseils et notes
Astuce :Vous pouvez accéder à la valeur d'un cookie nommé "user" via $HTTP_COOKIE_VARS["user"] ou $_COOKIE["user"].
Remarque :Lors de l'envoi d'un cookie, la valeur du cookie est automatiquement encodée en URL. Elle est automatiquement décodée en URL à la réception. Si vous n'en avez pas besoin, vous pouvez utiliser setrawcookie() à la place.
Exemple 1
Définir et envoyer un cookie :
$value = "my cookie value";
// envoyer un cookie simple
setcookie("TestCookie",$value);
?>
<html>
<body>
...
...
$value = "my cookie value";
// envoyer un cookie qui expire dans 24 heures
setcookie("TestCookie",$value, time()+3600*24);
?>
<html>
<body>
...
...
Exemple 2
Différentes façons de récupérer la valeur d'un cookie (après que le cookie a été défini) :
<body>
<?php
// Afficher les cookies individuellement
echo $_COOKIE["TestCookie"];
echo "<br />";
echo $HTTP_COOKIE_VARS["TestCookie"];
echo "<br />";
// Afficher tous les cookies
print_r($_COOKIE);
?>
</body>
</html>
Le code ci-dessus affichera :
ma valeur de cookie
Array ([TestCookie] => ma valeur de cookie)
Exemple 3
Supprimer un cookie en définissant sa date d'expiration à une date/heure passée :
// Définir la date d'expiration à une heure auparavant
setcookie ("TestCookie", "", time() - 3600);
?>
<html>
<body>
...
...
Exemple 4
Créer un cookie de type tableau :
setcookie("cookie[three]","cookiethree");
setcookie("cookie[two]","cookietwo");
setcookie("cookie[one]","cookieone");
// afficher les cookies (après rechargement de la page)
if (isset($_COOKIE["cookie"]))
{
foreach ($_COOKIE["cookie"] as $name => $value)
{
echo "$name : $value <br />";
}
}
?>
<html>
<body>
...
...
Le code ci-dessus affichera :
deux : cookietwo
un : cookieone
Manuel de référence complet PHP HTTP Autres extensions