Cookies (куки) — это механизм протокола HTTP, используемый для хранения данных браузером. Они позволяют отслеживать или идентифицировать возвращающихся посетителей. По сути, единственный надёжный способ понять что перед нами тот же самый пользователь (хотя если угнать чужие куки, то можно подделать запрос от другого пользователя). Куки использует не только сам сайт, но и всевозможные виджеты, которые встраиваются на разные странички. Именно благодаря кукам, гугл узнает вас и преследует рекламой того, что вы недавно искали, на сайтах, которые вроде бы не должны знать о ваших предпочтениях.

PHP прозрачно поддерживает работу с куками. Куки, приходящие в HTTP-запросе, становятся доступны через суперглобальный массив $_COOKIES. Этот массив используется только для чтения, писать в него бесполезно. Установка кук осуществляется функцией setcookie(). Так как куки отправляются вместе с заголовками, то вызов этой функции должен происходить до любой отправки данных в браузер.

В PSR-7 определены только два метода работающих с куками, и оба этих метода извлекают куки.

  • getCookieParams() — возвращает все куки
  • getCookieParam($name, $default = null) — возвращает указанную куку

Для установки кук придётся воспользоваться более низкоуровневым методом withHeader($name, $value), добавляющим любые заголовки в ответ:

<?php

$app->post('/example', function ($request, $response) {
    // Set-Cookie: <cookie-name>=<cookie-value>
    return $response->withHeader('Set-Cookie', "foo=bar");
});

Типичный вариант использования кук — корзина в интернет-магазине. Во время добавления товара, код магазина формирует куку, в которую начинает заносить данные о заказе.

<?php

$app->post('/cart-items', function ($request, $response) {
    // Информация о добавляемом товаре
    $item = $request->getParsedBodyParam('item');

    // Данные корзины
    $cart = json_decode($request->getCookieParam('cart', json_encode([])));

    // Добавление нового товара
    $cart[] = $item;

    // Кодирование корзины
    $encodedCart = json_encode($cart);

    // Установка новой корзины в куку
    return $response->withHeader('Set-Cookie', "cart={$encodedCart}")
        ->withRedirect('/');
});

Обратите внимание на необходимость кодирования данных корзины. Кука с точки зрения HTTP содержит значение в виде строки, а значит для хранения составных структур нужно проводить ручное кодирование в строку и декодирование при извлечении. Иногда простого кодирования недостаточно, особенно если данные имеют повышенную важность и их желательно защитить. В таких случаях дополнительно применяют шифрование на стороне сервера.

У кук существует ограничение на количество данных которые в них можно хранить, оно равно 4 кб. Для корзины интернет-магазина этого хватит с головой, но в других ситуациях может понадобится больше места, и тогда придётся воспользоваться сессией.

Самостоятельная работа

  1. Переделайте хранение пользователей на cookie.

Дополнительные материалы

  1. Официальная документация
Мы учим программированию с нуля до стажировки и работы. Попробуйте наш бесплатный курс «Введение в программирование» или полные программы обучения по Node, PHP, Python и Java.

Хекслет

Подробнее о том, почему наше обучение работает →