|
| 1 | +<?xml version="1.0" encoding="utf-8"?> |
| 2 | +<!-- $Revision$ --> |
| 3 | +<!-- EN-Revision: 141b05e576781405f9077abbe89e7a8b2a5eb946 Maintainer: mumumu Status: ready --> |
| 4 | +<variablelist xml:id="constant.curl-multi-setopt.constants" role="constant_list"> |
| 5 | + <title><function>curl_multi_setopt</function></title> |
| 6 | + <varlistentry xml:id="constant.curlmopt-chunk-length-penalty-size"> |
| 7 | + <term> |
| 8 | + <constant>CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE</constant> |
| 9 | + (<type>int</type>) |
| 10 | + </term> |
| 11 | + <listitem> |
| 12 | + <simpara> |
| 13 | + パイプライン処理における、チャンクの長さのしきい値をバイト単位で指定します。 |
| 14 | + PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。 |
| 15 | + </simpara> |
| 16 | + </listitem> |
| 17 | + </varlistentry> |
| 18 | + <varlistentry xml:id="constant.curlmopt-content-length-penalty-size"> |
| 19 | + <term> |
| 20 | + <constant>CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE</constant> |
| 21 | + (<type>int</type>) |
| 22 | + </term> |
| 23 | + <listitem> |
| 24 | + <simpara> |
| 25 | + パイプライン処理における、ペナルティのしきい値をバイト単位で指定します。 |
| 26 | + PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。 |
| 27 | + </simpara> |
| 28 | + </listitem> |
| 29 | + </varlistentry> |
| 30 | + <varlistentry xml:id="constant.curlmopt-maxconnects"> |
| 31 | + <term> |
| 32 | + <constant>CURLMOPT_MAXCONNECTS</constant> |
| 33 | + (<type>int</type>) |
| 34 | + </term> |
| 35 | + <listitem> |
| 36 | + <simpara> |
| 37 | + 同時に開く接続の最大数を指定します。 |
| 38 | + これを libcurl がキャッシュします。 |
| 39 | + デフォルトのサイズは、<function>curl_multi_add_handle</function> |
| 40 | + で追加したハンドル数の四倍に収まるように拡大されます。 |
| 41 | + キャッシュがいっぱいになると、curl はキャッシュ内で一番古い接続を閉じ、 |
| 42 | + 開いている接続の数が増えないようにします。 |
| 43 | + cURL 7.16.3 以降で利用可能です。 |
| 44 | + </simpara> |
| 45 | + </listitem> |
| 46 | + </varlistentry> |
| 47 | + <varlistentry xml:id="constant.curlmopt-max-concurrent-streams"> |
| 48 | + <term> |
| 49 | + <constant>CURLMOPT_MAX_CONCURRENT_STREAMS</constant> |
| 50 | + (<type>int</type>) |
| 51 | + </term> |
| 52 | + <listitem> |
| 53 | + <simpara> |
| 54 | + cURL が HTTP/2 接続でサポートすべき同時ストリームの最大数を指定します。 |
| 55 | + 有効な値の範囲は <literal>1</literal> から |
| 56 | + <literal>2147483647</literal>(<literal>2^31 - 1</literal>)です。 |
| 57 | + ここで指定された値は、 |
| 58 | + 他のシステムリソースのプロパティに基づいて適用されます。 |
| 59 | + デフォルトは <literal>100</literal> です。 |
| 60 | + PHP 8.2.0 以降 および cURL 7.67.0. 以降で利用可能です。 |
| 61 | + </simpara> |
| 62 | + </listitem> |
| 63 | + </varlistentry> |
| 64 | + <varlistentry xml:id="constant.curlmopt-max-host-connections"> |
| 65 | + <term> |
| 66 | + <constant>CURLMOPT_MAX_HOST_CONNECTIONS</constant> |
| 67 | + (<type>int</type>) |
| 68 | + </term> |
| 69 | + <listitem> |
| 70 | + <simpara> |
| 71 | + 単一ホストへの最大接続数を指定します。 |
| 72 | + PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。 |
| 73 | + </simpara> |
| 74 | + </listitem> |
| 75 | + </varlistentry> |
| 76 | + <varlistentry xml:id="constant.curlmopt-max-pipeline-length"> |
| 77 | + <term> |
| 78 | + <constant>CURLMOPT_MAX_PIPELINE_LENGTH</constant> |
| 79 | + (<type>int</type>) |
| 80 | + </term> |
| 81 | + <listitem> |
| 82 | + <simpara> |
| 83 | + パイプライン内の最大リクエスト数を指定します。 |
| 84 | + PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。 |
| 85 | + </simpara> |
| 86 | + </listitem> |
| 87 | + </varlistentry> |
| 88 | + <varlistentry xml:id="constant.curlmopt-max-total-connections"> |
| 89 | + <term> |
| 90 | + <constant>CURLMOPT_MAX_TOTAL_CONNECTIONS</constant> |
| 91 | + (<type>int</type>) |
| 92 | + </term> |
| 93 | + <listitem> |
| 94 | + <simpara> |
| 95 | + 同時に開くことができる、接続の最大数を指定します。 |
| 96 | + PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。 |
| 97 | + </simpara> |
| 98 | + </listitem> |
| 99 | + </varlistentry> |
| 100 | + <varlistentry xml:id="constant.curlmopt-pipelining"> |
| 101 | + <term> |
| 102 | + <constant>CURLMOPT_PIPELINING</constant> |
| 103 | + (<type>int</type>) |
| 104 | + </term> |
| 105 | + <listitem> |
| 106 | + <simpara> |
| 107 | + 1 を指定するとパイプラインが有効になり、 |
| 108 | + 0 を指定すると無効になります。 |
| 109 | + マルチハンドルでパイプラインを有効にすると、 |
| 110 | + このハンドルを使用した転送では可能な限り HTTP パイプラインを実行しようとします。 |
| 111 | + これは、既存の接続を利用可能な2つ目のリクエストを追加すると、 |
| 112 | + そのリクエストが同じ接続上で "パイプ" されることを意味します。 |
| 113 | + cURL 7.43.0 以降、この値はビットマスクとなり、 |
| 114 | + 2 を渡すと既存の HTTP/2 接続上で新規転送の多重化を試行します。 |
| 115 | + 3 を渡すと、パイプライン化と多重化を |
| 116 | + 互いに独立して要求するよう cURL に指示します。 |
| 117 | + cURL 7.62.0 以降は、パイプラインビットを設定しても効果がありません。 |
| 118 | + 整数リテラルではなく、CURLPIPE_* 定数も使用できます。 |
| 119 | + cURL 7.16.0 以降で利用可能です。 |
| 120 | + </simpara> |
| 121 | + </listitem> |
| 122 | + </varlistentry> |
| 123 | + <varlistentry xml:id="constant.curlmopt-pushfunction"> |
| 124 | + <term> |
| 125 | + <constant>CURLMOPT_PUSHFUNCTION</constant> |
| 126 | + (<type>int</type>) |
| 127 | + </term> |
| 128 | + <listitem> |
| 129 | + <para> |
| 130 | + サーバープッシュを処理するために登録する <type>callable</type> を渡します。 |
| 131 | + これは、以下のシグネチャを持ちます: |
| 132 | + <methodsynopsis> |
| 133 | + <type>int</type><methodname><replaceable>pushfunction</replaceable></methodname> |
| 134 | + <methodparam><type>resource</type><parameter>parent_ch</parameter></methodparam> |
| 135 | + <methodparam><type>resource</type><parameter>pushed_ch</parameter></methodparam> |
| 136 | + <methodparam><type>array</type><parameter>headers</parameter></methodparam> |
| 137 | + </methodsynopsis> |
| 138 | + <variablelist role="function_parameters"> |
| 139 | + <varlistentry> |
| 140 | + <term><parameter>parent_ch</parameter></term> |
| 141 | + <listitem> |
| 142 | + <simpara> |
| 143 | + 親の cURL ハンドル(クライアントが作成したリクエスト) |
| 144 | + </simpara> |
| 145 | + </listitem> |
| 146 | + </varlistentry> |
| 147 | + <varlistentry> |
| 148 | + <term><parameter>pushed_ch</parameter></term> |
| 149 | + <listitem> |
| 150 | + <simpara> |
| 151 | + プッシュされたリクエスト向けの、新しい cURL ハンドル |
| 152 | + </simpara> |
| 153 | + </listitem> |
| 154 | + </varlistentry> |
| 155 | + <varlistentry> |
| 156 | + <term><parameter>headers</parameter></term> |
| 157 | + <listitem> |
| 158 | + <simpara> |
| 159 | + push promise のヘッダ |
| 160 | + </simpara> |
| 161 | + </listitem> |
| 162 | + </varlistentry> |
| 163 | + </variablelist> |
| 164 | + プッシュ関数は、プッシュが処理できる場合は、<constant>CURL_PUSH_OK</constant> |
| 165 | + を返し、拒否する場合は <constant>CURL_PUSH_DENY</constant> を返すことが期待されています。 |
| 166 | + PHP 7.1.0 以降 および cURL 7.44.0 以降で利用可能です。 |
| 167 | + </para> |
| 168 | + </listitem> |
| 169 | + </varlistentry> |
| 170 | +</variablelist> |
0 commit comments