関数・クラス解説

curl_multi_setopt

version:PHP 5 >= 5.5.0, PHP 7 (公式)

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

公式リファレンス

書式

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

pushfunction ( resource $parent_ch , resource $pushed_ch , array $headers ) : int

説明

警告

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

パラメータ

mh
option
CURLMOPT_* 定数のいずれか。
value
option に設定する値。 value には int 型の値を指定しなければいけません。 option パラメータの値によって、それぞれ次のようになります。
オプション value の設定値
CURLMOPT_PIPELINING 1 を渡せば有効に、そして 0 を渡せば無効になります。 マルチハンドルでのパイプライン化を有効にすると、このハンドルによる転送で、 可能な限り HTTP パイプライン化を試みます。 つまり、二番目のリクエストを追加したときに既存の接続が使える場合は、 既存の接続に「パイプ」でつなぎます。 cURL 7.43.0 以降では、この値はビットマスクですが、 2 を渡すと、既存の HTTP/2 接続上での新しい転送で、 可能な限り多重化を試みます。 3 を渡すと、パイプライン化と多重化を互いに独立して行うよう cURL に指示します。 cURL 7.62.0 以降は、パイプライン化のbitを設定しても効果はありません。
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 サーバープッシュを扱うために登録される callable を渡し、以下のようなシグナチャをとります:
parent_ch
親となる cURL ハンドル(クライアントが作成したリクエストの)
pushed_ch
プッシュされたリクエストのための、新しい cURL ハンドル
headers
プッシュのためのプロミスヘッダ
プッシュ関数自体は、プッシュをハンドルできる場合は CURL_PUSH_OK を返し、 拒否する場合は、CURL_PUSH_DENY を返すことが想定されています。

返値

成功した場合に 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 が追加されました。

ワード検索


※入力キーワードが、関数名・説明文・タグに含まれるものを検索

関数名アルファベット別

A B C D E F G H I J
K L M N O P Q R S T
U V W X Y Z _

最終更新一覧

stristr
 大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

stripslashes
 バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

stripos
 大文字小文字を区別せずに文字列が最初に現れる位置を取得する

stripcslashes
 addcslashes() でクォートされた文字列をアンクォートする

strip_tags
 文字列から HTML と PHP のタグを除去して返却

strcspn
 指定した文字が最初に現れる位置を調べる

strcoll
 ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

strcmp
 2つの文字列を比較し同じか(あるいは大小)を判定する

strchr
 strstr() のエイリアス

strcasecmp
 2つの文字列を比較(大文字小文字を区別せず同じとみなす)

カテゴリー一覧

PHP の振る舞いの変更
音声フォーマットの操作
認証サービス
コマンドライン関連
圧縮およびアーカイブ
暗号
データベース関連
日付および時刻関連
ファイルシステム
自然言語および文字エンコーディング
画像処理および作成
メール関連
数学
テキスト以外の MIME 型
プロセス制御
その他の基本モジュール
その他のサービス
検索エンジン用の拡張モジュール
サーバー固有のモジュール
セッション関連
テキスト処理
変数・データ型関連
ウェブサービス
Windows 用のモジュール
XML 操作
GUI用の拡張モジュール