PHP setrawcookie()Fonctions


PHP HTTP 参考手册Manuel de référence complet PHP HTTP

Définition et utilisation

La fonction setrawcookie() envoie un cookie HTTP sans encoder la valeur du cookie en URL.

Un cookie est une variable envoyée par le serveur au navigateur. Un cookie est généralement un petit fichier texte que le serveur intègre dans l'ordinateur de l'utilisateur. Ce cookie est envoyé chaque fois que le même ordinateur demande une page via un navigateur.

Le nom du cookie est automatiquement attribué à une variable du même nom. Par exemple, si un cookie nommé "user" est envoyé, une variable nommée $user est automatiquement créée contenant 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

setrawcookie(name,value,expire,path,domain,secure)

Paramètre 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 fonctionnera dans tout le domaine. Si le chemin est défini sur "/test/", le cookie fonctionnera dans le répertoire test et tous ses sous-répertoires. La valeur de chemin par défaut est le répertoire courant où le cookie est situé.

domain Facultatif. Spécifie le domaine du cookie.

Pour que le cookie fonctionne 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 ne fonctionnera 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 :La fonction setrawcookie() est presque identique à la fonction setcookie(), sauf qu'elle n'encode pas automatiquement la valeur du cookie en URL lorsqu'elle est envoyée au client.


Exemple 1

Définir et envoyer un cookie :

<?php
$value = "my cookie value";

// envoyer un cookie simple
setrawcookie("TestCookie",$value);
?>

<html>
<body>

...
...

<?php
$value = "my cookie value";

// envoyer un cookie qui expire dans 24 heures
setrawcookie("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) :

<html>
<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
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 :

<?php
// Définir la date d'expiration à une heure auparavant
setrawcookie ("TestCookie", "", time() - 3600);
?>

<html>
<body>

...
...


Exemple 4

Créer un cookie de type tableau :

<?php
setrawcookie("cookie[three]","cookiethree");
setrawcookie("cookie[two]","cookietwo");
setrawcookie("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 :

three : cookiethree
deux : cookietwo
un : cookieone


PHP HTTP 参考手册Manuel de référence complet PHP HTTP Autres extensions