curl_multi_setopt
(PHP 5 >= 5.5.0, PHP 7)
curl_multi_setopt — cURL マルチハンドル用のオプションを設定する
説明
警告
この関数は、 現在のところ詳細な情報はありません。引数のリストのみが 記述されています。
パラメータ
-
mh -
-
option -
CURLMOPT_*定数のいずれか。 -
value -
optionに設定する値。valueには int 型の値を指定しなければいけません。optionパラメータの値によって、それぞれ次のようになります。オプション valueの設定値CURLMOPT_PIPELINING1 を渡せば有効に、そして 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_PUSHFUNCTIONPass a callable that will be registered to handle server pushes and should have the following signature: pushfunction ( resource$parent_ch, resource$pushed_ch, array$headers) : int-
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.
CURL_PUSH_OKif it can handle the push, orCURL_PUSH_DENYto reject it. -
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 7.1.0 |
CURLMOPT_PUSHFUNCTION が追加されました。
|
| 7.0.7 |
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE、
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE、
CURLMOPT_MAX_HOST_CONNECTIONS、
CURLMOPT_MAX_PIPELINE_LENGTH、
CURLMOPT_MAX_TOTAL_CONNECTIONS
が追加されました。
|