array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.curl-share-init-persistent.php', 1 => 'curl_share_init_persistent', 2 => 'Инициализирует постоянный разделяемый cURL-дескриптор', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'Функции cURL', ), 'prev' => array ( 0 => 'function.curl-share-init.php', 1 => 'curl_share_init', ), 'next' => array ( 0 => 'function.curl-share-setopt.php', 1 => 'curl_share_setopt', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/curl/functions/curl-share-init-persistent.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

curl_share_init_persistent

(PHP 8 >= 8.5.0)

curl_share_init_persistent — Инициализирует постоянный разделяемый cURL-дескриптор

Описание

curl_share_init_persistent(array $share_options): CurlSharePersistentHandle

Функция инициализирует постоянный разделяемый дескриптор модуля cURL с общими параметрами. В отличие от функции curl_share_init(), дескрипторы, которые создаёт эта функция, не уничтожаются в конце PHP-запроса. Модуль переиспользует постоянный разделяемый дескриптор с тем же набором общих опций, которые установили в параметре share_options, если обнаружит такой.

Список параметров

share_options
Непустой массив констант семейства CURL_LOCK_DATA_*.

Замечание: В параметр нельзя передавать константу CURL_LOCK_DATA_COOKIE, функция выбросит ошибку ValueError, если не соблюдать это ограничение. Совместный доступ PHP-запросов к блокам данных cookies создаёт риск непреднамеренного перепутывания чувствительных блоков данных cookies между пользователями.

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

Функция возвращает объект класса CurlSharePersistentHandle.

Ошибки

Примеры

Пример #1 Пример инициализации постоянного разделяемого cURL-дескриптора функцией curl_share_init_persistent()

Пример создаст постоянный общий cURL-дескриптор и покажет совместный доступ соединений к дескриптору. При выполнении сеансов передачи данных через долгоживущий SAPI-интерфейс языка PHP дескриптор $sh сохранится между SAPI-запросами.

<?php

// Создаём или получаем постоянный общий cURL-дескриптор, который настроен на совместную работу с DNS-запросами и подключениями
$sh = curl_share_init_persistent([CURL_LOCK_DATA_DNS, CURL_LOCK_DATA_CONNECT]);

// Инициализируем первый cURL-дескриптор и назначаем ему общий дескриптор
$ch1 = curl_init("http://example.com/");
curl_setopt($ch1, CURLOPT_SHARE, $sh);

// Выполняем первый cURL-дескриптор.
// Модуль совершит попытку передать данные через предыдущее соединение,
// если соединение открыли в предыдущем SAPI-запросе
curl_exec($ch1);

// Инициализируем второй cURL-дескриптор и назначаем ему общий дескриптор
$ch2 = curl_init("http://example.com/");
curl_setopt($ch2, CURLOPT_SHARE, $sh);

// Выполняем второй cURL-дескриптор. Модуль передаст данные через соединение дескриптора $ch1
curl_exec($ch2);

?>

Смотрите также