Класс CookieCollection
Контейнерный класс для файлов cookie, используемых в Http\Client.
Обеспечивает функции типа cookie-хранилища для хранения файлов cookie между запросами, а также добавления файлов cookie к новым запросам.
- Cake\Http\Cookie\CookieCollection implements IteratorAggregate, Countable
-
Cake\Http\Client\CookieCollection
Устарело: 3.5.0 Используйте Cake\Http\Cookie\CookieCollection вместо этого.
Расположение: Http/Client/CookieCollection.php
Наследуемые свойства
Краткое описание методов
- convertCookieToArray() protectedПреобразовать файл cookie в массив его свойств.
- get() publicПолучить сохранённые файлы cookie для URL.
- getAll() publicПолучить все сохранённые файлы cookie в виде массивов.
- store() publicСохранить файлы cookie из ответа.
Подробное описание методов
convertCookieToArray()source protected
convertCookieToArray( Cake\Http\Cookie\CookieInterface $cookie )
Преобразовать файл cookie в массив его свойств.
В основном полезно в случаях, когда нужна обратная совместимость.
Параметры
-
Cake\Http\Cookie\CookieInterface$cookie - Объект файла cookie.
Возвращаемое значение
массивget()source public
get( string $url )
Получить сохранённые файлы cookie для URL.
Находит соответствующие сохранённые файлы cookie и возвращает простой массив имени => значение
Параметры
- строка
$url - URL для поиска файлов cookie.
Возвращаемое значение
массивПереопределяет
Cake\Http\Cookie\CookieCollection::get() getAll()source public
getAll( )
Получить все сохранённые файлы cookie в виде массивов.
Возвращаемое значение
массивstore()source public
store( Cake\Http\Client\Response $response , string $url )
Сохранить файлы cookie из ответа.
Сохранить файлы cookie, которые не истекли. Если файл cookie истек и он сейчас хранится, он будет удалён.
Параметры
-
Cake\Http\Client\Response$response - Ответ для чтения файлов cookie
- строка
$url - URL запроса, используемый для значений по умолчанию хоста/пути.
Методы, унаследованные от Cake\Http\Cookie\CookieCollection
__construct()source public
__construct( array $cookies [] )
Конструктор
Параметры
- массив
$cookiesнеобязательно [] - Массив объектов файлов cookie
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\CookieCollectionaddFromResponse()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\CookieCollectionaddToRequest()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
Исключения
InvalidArgumentExceptioncount()source public
count( )
Получить количество файлов cookie в коллекции.
Возвращаемое значение
целое числоРеализация
Countable::count() createFromHeader()source public static
createFromHeader( array $header )
Создать Cookie Collection из массива заголовков Set-Cookie
Параметры
- массив
$header - Массив значений заголовков set-cookie.
Возвращаемое значение
Cake\Http\Cookie\CookieCollectioncreateFromServerRequest()source public static
createFromServerRequest( Psr\Http\Message\ServerRequestInterface $request )
Создать новую коллекцию из файлов cookie в ServerRequest
Параметры
- Psr\Http\Message\ServerRequestInterface
$request - Запрос для извлечения данных файлов cookie
Возвращаемое значение
Cake\Http\Cookie\CookieCollectionfindMatchingCookies()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 для проверки.
Возвращаемое значение
логическое значение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\CookieCollectionremoveExpiredCookies()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–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.Client.CookieCollection.html