Spec-Zone.ru › CakePHP 3.5

Класс CookieCollection

Коллекция Cookie

Обеспечивает неизменяемую коллекцию объектов cookie. Добавление или удаление элементов в коллекцию возвращает новую коллекцию, которую необходимо сохранить.

Cake\Http\Cookie\CookieCollection реализует IteratorAggregate, Countable

Непосредственные подклассы

  • Cake\Http\Client\CookieCollection
Пространство имён: Cake\Http\Cookie
Расположение: Http/Cookie/CookieCollection.php

Краткое описание свойств

  • $cookies protected
    Cake\Http\Cookie\CookieInterface[]
    Объекты cookie

Краткое описание методов

  • __construct() public
    Конструктор
  • add() public
    Добавить cookie и получить обновлённую коллекцию.
  • addFromResponse() public
    Создать новую коллекцию, включающую cookie из ответа.
  • addToRequest() public
    Добавить cookie, соответствующие пути/домену/сроку действия, в запрос.
  • checkCookies() protected
    Проверяет, содержатся ли в массиве только допустимые объекты cookie
  • count() public
    Получить количество cookie в коллекции.
  • createFromHeader() public static
    Создать коллекцию Cookie из массива заголовков Set-Cookie
  • createFromServerRequest() public static
    Создать новую коллекцию из cookie в ServerRequest
  • findMatchingCookies() protected
    Найти cookie, соответствующие схеме, хосту и пути
  • get() public
    Получить первое cookie по имени.
  • getIterator() public
    Получить итератор
  • has() public
    Проверить, существует ли cookie с заданным именем
  • parseSetCookieHeader() protected static
    Парсинг заголовков Set-Cookie в массив
  • remove() public
    Создать новую коллекцию со всеми cookie, соответствующими $name, удалёнными.
  • removeExpiredCookies() protected
    Удалить просроченные cookie из коллекции.
  • setRequestDefaults() protected
    Применить путь и хост к набору cookie, если они не заданы.

Подробное описание методов

__construct()source public

__construct( array $cookies [] )

Конструктор

Параметры

массив $cookies необязательно []
Массив объектов cookie

add()source public

add( Cake\Http\Cookie\CookieInterface $cookie )

Добавить cookie и получить обновлённую коллекцию.

Cookie хранятся по id. Это означает, что могут быть дублированные cookie, если коллекция cookie используется для cookie на нескольких доменных зонах. Это может повлиять на поведение get(), has() и remove().

Параметры

Cake\Http\Cookie\CookieInterface $cookie
Экземпляр cookie для добавления.

Возвращает

Cake\Http\Cookie\CookieCollection

addFromResponse()source public

addFromResponse( Psr\Http\Message\ResponseInterface $response , Psr\Http\Message\RequestInterface $request )

Создать новую коллекцию, включающую cookie из ответа.

Параметры

Psr\Http\Message\ResponseInterface $response
Ответ для извлечения cookie.
Psr\Http\Message\RequestInterface $request
Запрос для получения контекста cookie.

Возвращает

Cake\Http\Cookie\CookieCollection

addToRequest()source public

addToRequest( Psr\Http\Message\RequestInterface $request , array $extraCookies [] )

Добавить cookie, соответствующие пути/домену/сроку действия, в запрос.

Это позволяет использовать CookieCollection в качестве «банка cookie» в ситуации с HTTP-клиентом. Cookie, соответствующие домену + пути запроса, которые не просрочены на момент вызова этого метода, будут добавлены в запрос.

Параметры

Psr\Http\Message\RequestInterface $request
Запрос для обновления.
массив $extraCookies необязательно []

Ассоциативный массив дополнительных cookie для добавления в запрос. Это полезно, когда у вас есть данные cookie извне коллекции, которые вы хотите отправить.

Возвращает

Psr\Http\Message\RequestInterface
Обновлённый запрос.

checkCookies()source protected

checkCookies( array $cookies )

Проверяет, содержатся ли в массиве только допустимые объекты cookie

Параметры

массив $cookies
Массив объектов cookie

Исключения

InvalidArgumentException

count()source public

count( )

Получить количество cookie в коллекции.

Возвращает

целое число

Реализация

Countable::count()

createFromHeader()source public static

createFromHeader( array $header )

Создать коллекцию Cookie из массива заголовков Set-Cookie

Параметры

массив $header
Массив значений заголовков set-cookie.

Возвращает

Cake\Http\Cookie\CookieCollection

createFromServerRequest()source public static

createFromServerRequest( Psr\Http\Message\ServerRequestInterface $request )

Создать новую коллекцию из cookie в ServerRequest

Параметры

Psr\Http\Message\ServerRequestInterface $request
Запрос для извлечения данных cookie

Возвращает

Cake\Http\Cookie\CookieCollection

findMatchingCookies()source protected

findMatchingCookies( string $scheme , string $host , string $path )

Найти cookie, соответствующие схеме, хосту и пути

Параметры

строка $scheme
Схема http для соответствия
строка $host
Хост для соответствия.
строка $path
Путь для соответствия

Возвращает

массив
Массив пар имя/значение cookie

get()source public

get( string $name )

Получить первое cookie по имени.

Параметры

строка $name
Имя cookie.

Возвращает

Cake\Http\Cookie\CookieInterface|null

getIterator()source public

getIterator( )

Получить итератор

Возвращает

ArrayIterator

Реализация

IteratorAggregate::getIterator()

has()source public

has( string $name )

Проверить, существует ли cookie с заданным именем

Параметры

string $name
Имя cookie для проверки.

Возвращает

boolean
True, если cookie существует, иначе false.

parseSetCookieHeader()source protected static

parseSetCookieHeader( array $values )

Разбор заголовков Set-Cookie в массив

Параметры

array $values
Список значений заголовков Set-Cookie.

Возвращает

Cake\Http\Cookie\Cookie[]
Массив объектов cookie

remove()source public

remove( string $name )

Создать новую коллекцию со всеми cookie, соответствующими $name, удалёнными.

Если cookie не находится в коллекции, этот метод ничего не сделает.

Параметры

string $name
Имя cookie для удаления.

Возвращает

Cake\Http\Cookie\CookieCollection

removeExpiredCookies()source protected

removeExpiredCookies( string $host , string $path )

Удаление истекших cookie из коллекции.

Параметры

string $host
Хост для проверки истекших cookie.
string $path
Путь для проверки истекших cookie.

setRequestDefaults()source protected

setRequestDefaults( array $cookies , string $host , string $path )

Применение пути и хоста к набору cookie, если они не заданы.

Параметры

array $cookies
Массив cookie для обновления.
string $host
Хост для установки.
string $path
Путь для установки.

Возвращает

array
Массив обновлённых cookie.

Подробное описание свойств

$cookiessource

protected Cake\Http\Cookie\CookieInterface[]

Объекты cookie

[]

© 2005–2018 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.5/class-Cake.Http.Cookie.CookieCollection.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API