Файлы cookie PHP
Что такое cookie?
Файл cookie — это небольшой текстовый файл, который позволяет хранить небольшой объем данных (около 4 КБ) на компьютере пользователя. Каждый раз, когда тот же компьютер запрашивает страницу в браузере, он также отправляет файл cookie. Обычно они используются для отслеживания такой информации, как имя пользователя, которое сайт может получить для персонализации страницы, когда пользователь посетит сайт в следующий раз. С помощью PHP вы можете как создавать, так и получать значения файлов cookie.
Создание файлов cookie
Файл cookie создается с помощью функции setcookie()
.
Синтаксис
Обязательный параметр — это только параметр name
. Все остальные параметры необязательны.
Параметры функции setcookie():
name
— устанавливает имя файла cookie и сохраняется в переменной средыHTTP_COOKIE_VARS
. Эта переменная используется для доступа к файлам cookievalue
— используется для установки значения cookieexpire
— срок действия, после которого cookie уничтожаются. Если этот параметр не установлен, то срок действия cookie автоматически истечет при закрытии веб-браузера.path
— путь к каталогу на сервере, для которого будут доступны cookie. Если задать '/', cookie будут доступны для всего сайта. Если задать, например,'/mykatalog/'
, cookie будут доступны только из каталога /mykatalog/' и всех его подкаталогов. По умолчанию значением является текущий каталог, в котором устанавливаются cookie.domain
— задает домен, для которого будут доступны cookie. Если это домен второго уровня, например, hostname.com, то cookie доступны для всего сайта hostname.com, в том числе и для его поддоменов типа blog.hostname.com.Если задан поддомен blog.hostname.com, то cookie доступны только внутри этого поддомена.
secure
— может быть установлено значение1
, чтобы указать, что файл cookie должен отправляться только путем безопасной передачи с использованием HTTPS, в противном случае установлено значение0
, означает, что cookie может быть отправлен по обычному протоколу HTTP.httponly
— если равноtrue
, cookie будут доступны только через http протокол. То есть cookie в этом случае не будут доступны скриптовым языкам, например, JavaScript. По умолчанию параметр равенfalse
В следующем примере создадим файл cookie с именем "user" и значением "Max Maximov". Срок действия cookie истечет через 7 дней (86400 * 7). Параметр /
означает, что файл cookie доступен на всех страницах веб-сайта.
С помощью PHP-скрипта получаем значение файла cookie "user", используя глобальную переменную $_COOKIE
. Чтобы узнать, установлен ли cookie мы используем функцию isset()
:
Пример
Попробуй сам »<?php
$cookie_name = "user";
$cookie_value = "Max Maximov";
setcookie($cookie_name, $cookie_value, time() + (86400 * 7), "/"); // 86400 сек = 1 сутки
?>
<html>
<body>
<?php
if(!isset($_COOKIE[$cookie_name])) {
echo "Куки с именем '" . $cookie_name . "' не установлен!";
} else {
echo "Куки '" . $cookie_name . "' установлен!<br>";
echo "Значение: " . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
Примечание: Функция setcookie()
должна быть объявлена ПЕРЕД тегом <html>.
Значение файла cookie автоматически кодируется URL-адресом при его отправке и автоматически декодируется при получении. Для предотвращения URL-кодирования используйте функцию setrawcookie()
.
Изменение cookie
Если Вы хотите изменить значение cookie на новое, вы можете просто переписать его значение. Таким образом, даже если браузер уже посылал значение cookie серверу на одной из предыдущих страниц, вполне возможно сообщить серверу, что в действительности значение теперь другое.
В следующем примере изменим значение файла cookie "user", просто установив его снова с помощью функции setcookie()
:
Пример
Попробуй сам »<?php
$cookie_name = "user";
$cookie_value = "Maxim White";
setcookie($cookie_name, $cookie_value, time() + (86400 * 7), "/"); // 86400 сек = 1 сутки
?>
<html>
<body>
<?php
if(!isset($_COOKIE[$cookie_name])) {
echo "Куки с именем '" . $cookie_name . "' не установлен!";
} else {
echo "Куки '" . $cookie_name . "' установлен!<br>";
echo "Значение: " . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
Сохранение массивов в cookie
Мы может установить массив favorits
, используя квадратные скобки в именах favorits[]
, а затем прочитать массив favorits
и значения этого массива:
Пример
Попробуй сам »<?php
// Устанавливаем массив:
setcookie("favorits[1]", "product_id_1");
setcookie("favorits[2]", "product_id_2");
setcookie("favorits[9]", "product_id_9");
?>
<html>
<body>
<?php
// После перезагрузки страницы, выведем cookie
if (isset($_COOKIE["favorits"])) {
foreach ($_COOKIE["favorits"] as $id => $val) {
$id = htmlspecialchars($id);
echo "$id. $val <br>";
}
}
?>
</body>
</html>
Удаление cookie
Официально, чтобы удалить файл cookie, нужно вызвать функцию setcookie()
только с аргументом name
, но этот способ не всегда работает, и на него не следует полагаться.
Чтобы удалить файл cookie безопаснее всего установить cookie с датой, которая уже истекла:
Пример
Попробуй сам »<?php
// устанавливаем срок годности один час назад
setcookie("user", "", time() - 3600);
?>
<html>
<body>
<?php
echo "Куки 'user' удалён.";
?>
</body>
</html>
Проверьте, включены ли файлы cookie
Для проверки существования cookie сначала создадим файл cookie new_cookie
со значением new_test
. Затем просто c помощью функции count()
подсчитаем количество элементов массива $_COOKIE
:
Пример
Попробуй сам »<?php
setcookie("new_cookie", "new_test", time() + 3600, '/');
?>
<html>
<body>
<?php
if(count($_COOKIE) > 0) {
echo "Файлы cookie включены";
} else {
echo "Файлы cookie отключены";
}
?>
</body>
</html>