PHP 7.1.12 Released

curl_multi_setopt

(PHP 5 >= 5.5.0, PHP 7)

curl_multi_setoptcURL マルチハンドル用のオプションを設定する

説明

bool curl_multi_setopt ( resource $mh , int $option , mixed $value )

警告

この関数は、 現在のところ詳細な情報はありません。引数のリストのみが 記述されています。

パラメータ

mh

option

CURLMOPT_* 定数のいずれか。

value

option に設定する値。

value には int 型の値を指定しなければいけません。 option パラメータの値によって、それぞれ次のようになります。

オプション value の設定値
CURLMOPT_PIPELINING 1 を渡せば有効に、そして 0 を渡せば無効になります。 マルチハンドルでのパイプライン化を有効にすると、このハンドルによる転送で、 可能な限り HTTP パイプライン化を試みます。 つまり、二番目のリクエストを追加したときに既存の接続が使える場合は、 既存の接続に「パイプ」でつなぎます。 cURL 7.43.0 以降では、2 を渡すと、既存の HTTP/2 接続上での新しい転送で、 可能な限り多重化を試みます。
CURLMOPT_MAXCONNECTS 同時に開く接続の最大数を指定します。これを libcurl がキャッシュします。 デフォルトのサイズは、 curl_multi_add_handle() で追加したハンドル数の四倍に収まるように拡大されます。 キャッシュがいっぱいになると、キャッシュ内で一番古い接続を閉じ、 開いている接続の数が増えないようにします。
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE パイプライン化のチャンク長の閾値をバイト単位で指定します。
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE パイプライン化のペナルティの閾値をバイト単位で指定します。
CURLMOPT_MAX_HOST_CONNECTIONS 単一のホストへの最大接続数を指定します。
CURLMOPT_MAX_PIPELINE_LENGTH 単一のパイプライン内での最大リクエスト数を指定します。
CURLMOPT_MAX_TOTAL_CONNECTIONS 同時にオープンする接続の最大数を指定します。
CURLMOPT_PUSHFUNCTION Pass a callable that will be registered to handle server pushes and should have the following signature:
int pushfunction ( resource $parent_ch , resource $pushed_ch , array $headers )
parent_ch

The parent cURL handle (the request the client made).

pushed_ch

A new cURL handle for the pushed request.

headers

The push promise headers.

The push function is supposed to return either CURL_PUSH_OK if it can handle the push, or CURL_PUSH_DENY to reject it.

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

変更履歴

バージョン 説明
7.1.0 CURLMOPT_PUSHFUNCTION が追加されました。
7.0.7 CURLMOPT_CHUNK_LENGTH_PENALTY_SIZECURLMOPT_CONTENT_LENGTH_PENALTY_SIZECURLMOPT_MAX_HOST_CONNECTIONSCURLMOPT_MAX_PIPELINE_LENGTHCURLMOPT_MAX_TOTAL_CONNECTIONS が追加されました。

add a note add a note

User Contributed Notes 1 note

up
-1
ryosuke_i_628 at yahoo dot co dot jp
1 year ago
If you want to enable both HTTP/1.1 pipelining and HTTP/2 multiplexing...

<?php
curl_multi_setopt
($mh, CURLMOPT_PIPELINING, 3);
?>

or

<?php
curl_multi_setopt
($mh, CURLMOPT_PIPELINING, CURLPIPE_HTTP1 | CURLPIPE_MULTIPLEX);
?>
To Top