Spec-Zone.ru › CakePHP 3.7

Класс CookieCollection

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

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

Cake\Http\Cookie\CookieCollection implements IteratorAggregate, Countable
Extended by 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 )

Создать коллекцию 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

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.

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

Spec-Zone.ru

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