Spec-Zone.ru › CakePHP 3.8

Класс CookieCollection

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

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

Cake\Http\Cookie\CookieCollection implements 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
    Преобразовать куки в массив его свойств.
  • get() public deprecated
    Получить сохранённые куки для URL.
  • getAll() public deprecated
    Получить все сохранённые куки в виде массивов.
  • store() public deprecated
    Сохранить куки из ответа.

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

__construct()source public deprecated

__construct( array $cookies = [] )

Конструктор

Параметры

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

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

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

convertCookieToArray()source protected deprecated

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

Преобразовать куки в массив его свойств.

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

Параметры

Cake\Http\Cookie\CookieInterface $cookie
Объект cookie.

Возвращает

массив

get()source public deprecated

get( string $url )

Получить сохранённые куки для URL.

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

Параметры

строка $url
URL для поиска куки.

Возвращает

массив

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

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

getAll()source public deprecated

getAll( )

Получить все сохранённые куки в виде массивов.

Возвращает

массив

store()source public deprecated

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

Сохранить куки из ответа.

Сохранить куки, которые не истекли. Если куки истекли и в настоящее время сохранены, они будут удалены.

Параметры

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

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

add()source public

add( Cake\Http\Cookie\CookieInterface $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 )

Создать новый набор, включающий куки из ответа.

Параметры

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

Возвращает

Cake\Http\Cookie\CookieCollection

addToRequest()source public

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

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

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

Параметры

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

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

Возвращает

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

checkCookies()source protected

checkCookies( array $cookies )

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

Параметры

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

Вызывает

InvalidArgumentException

count()source public

count( )

Получить количество куки в наборе.

Возвращает

целое число

Реализация

Countable::count()

createFromHeader()source public static

createFromHeader( array $header )

Создать набор куки из массива заголовков Set-Cookie

Параметры

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

Возвращает

Cake\Http\Cookie\CookieCollection

createFromServerRequest()source public static

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

Создать новый набор из куки в ServerRequest

Параметры

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

Возвращает

Cake\Http\Cookie\CookieCollection

findMatchingCookies()source protected

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

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

Параметры

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

Возвращает

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

getIterator()source public

getIterator( )

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

Возвращает

ArrayIterator

Реализация

IteratorAggregate::getIterator()

has()source public

has( string $name )

Проверка наличия куки с заданным именем

Параметры

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

Возвращает

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

parseSetCookieHeader()source protected static

parseSetCookieHeader( array $values )

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

Параметры

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

Возвращает

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

remove()source public

remove( string $name )

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

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

Параметры

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

Возвращает

Cake\Http\Cookie\CookieCollection

removeExpiredCookies()source protected

removeExpiredCookies( string $host , string $path )

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

Параметры

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

setRequestDefaults()source protected

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

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

Параметры

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

Возвращает

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

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

Spec-Zone.ru

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