Spec-Zone.ru › CakePHP 3.6

Класс CookieCollection

Контейнерный класс для файлов cookie, используемых в Http\Client.

Обеспечивает функциональность cookie-хранилища для хранения файлов cookie между запросами, а также добавления файлов cookie к новым запросам.

Cake\Http\Cookie\CookieCollection реализует IteratorAggregate, Countable
Расширенный Cake\Http\Client\CookieCollection
Пространство имён: Cake\Http\Client
Устарело: 3.5.0 Используйте Cake\Http\Cookie\CookieCollection вместо этого.
Расположение: Http/Client/CookieCollection.php

Унаследованные свойства

  • cookies

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

  • __construct() public deprecated
    Конструктор
  • convertCookieToArray() protected deprecated
    Преобразование файла cookie в массив его свойств.
  • get() public deprecated
    Получение сохранённых файлов cookie для URL.
  • getAll() public deprecated
    Получение всех сохранённых файлов cookie в виде массивов.
  • store() public deprecated
    Сохранение файлов cookie из ответа.

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

__construct()source public deprecated

__construct( array $cookies = [] )

Конструктор

Параметры

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

Переопределяет

Cake\Http\Cookie\CookieCollection::__construct()

convertCookieToArray()source protected deprecated

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

Преобразование файла cookie в массив его свойств.

В основном полезно, когда требуется обратная совместимость.

Параметры

Cake\Http\Cookie\CookieInterface $cookie
Объект файла cookie.

Возвращает

массив

get()source public deprecated

get( string $url )

Получение сохранённых файлов cookie для URL.

Находит соответствующие сохранённые файлы cookie и возвращает простой массив имя => значение

Параметры

строка $url
URL для поиска файлов cookie.

Возвращает

массив

Переопределяет

Cake\Http\Cookie\CookieCollection::get()

getAll()source public deprecated

getAll( )

Получение всех сохранённых файлов cookie в виде массивов.

Возвращает

массив

store()source public deprecated

store( Cake\Http\Client\Response $response , string $url )

Сохранение файлов cookie из ответа.

Сохранение файлов cookie, которые не истекли. Если файл cookie истек и в данный момент сохранён, он будет удалён.

Параметры

Cake\Http\Client\Response $response
Ответ для чтения файлов cookie
строка $url
URL запроса, используемый для значений по умолчанию для хоста/пути.

Методы, унаследованные от Cake\Http\Cookie\CookieCollection

add()source public

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

Добавление файла cookie и получение обновлённой коллекции.

Файлы cookie хранятся по идентификатору. Это означает, что могут быть дублированные файлы 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, соответствующих пути/домену/сроку действия, в запрос.

Это позволяет использовать CookieCollections в качестве 'хранилища файлов 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 )

Создание CookieCollection из массива заголовков 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

getIterator()source public

getIterator( )

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

Возвращает

ArrayIterator

Реализация

IteratorAggregate::getIterator()

has()source public

has( string $name )

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

Параметры

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

Возвращаемое значение

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

parseSetCookieHeader()source protected static

parseSetCookieHeader( array $values )

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

Параметры

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

Возвращаемое значение

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

remove()source public

remove( string $name )

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

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

Параметры

строка $name
Имя cookie для удаления.

Возвращаемое значение

Cake\Http\Cookie\CookieCollection

removeExpiredCookies()source protected

removeExpiredCookies( string $host , string $path )

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

Параметры

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

setRequestDefaults()source protected

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

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

Параметры

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

Возвращаемое значение

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

© 2005–present 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.6/class-Cake.Http.Client.CookieCollection.html

Spec-Zone.ru

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