array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), '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' => 'ja', '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 リクエスト間で Cookie を共有すると、 ユーザー間でセンシティブなデータがうっかり混在する可能性があるからです。

戻り値

CurlSharePersistentHandle を返します。

エラー / 例外

例

例1 curl_share_init_persistent() の例

この例では、持続的な cURL 共有ハンドルを作成し、 接続を共有する方法を示します。 このコードを長く生き残る PHP SAPI で実行した場合、 $sh は SAPI リクエスト間で生き残ります。

<?php

// Create or retrieve a persistent cURL share handle set to share DNS lookups and connections
$sh = curl_share_init_persistent([CURL_LOCK_DATA_DNS, CURL_LOCK_DATA_CONNECT]);

// Initialize the first cURL handle and assign the share handle to it
$ch1 = curl_init("http://example.com/");
curl_setopt($ch1, CURLOPT_SHARE, $sh);

// Execute the first cURL handle. This may reuse the connection from an earlier SAPI request
curl_exec($ch1);

// Initialize the second cURL handle and assign the share handle to it
$ch2 = curl_init("http://example.com/");
curl_setopt($ch2, CURLOPT_SHARE, $sh);

// Execute the second cURL handle. This will reuse the connection from $ch1
curl_exec($ch2);

?>

参考