archived-doc-ja/reference/curl/constants_curl_multi_setopt.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 141b05e576781405f9077abbe89e7a8b2a5eb946 Maintainer: mumumu Status: ready -->
<variablelist xml:id="constant.curl-multi-setopt.constants" role="constant_list">
 <title><function>curl_multi_setopt</function></title>
  <varlistentry xml:id="constant.curlmopt-chunk-length-penalty-size">
   <term>
    <constant>CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     パイプライン処理における、チャンクの長さのしきい値をバイト単位で指定します。
     PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.curlmopt-content-length-penalty-size">
   <term>
    <constant>CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     パイプライン処理における、ペナルティのしきい値をバイト単位で指定します。
     PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.curlmopt-maxconnects">
   <term>
    <constant>CURLMOPT_MAXCONNECTS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
	 同時に開く接続の最大数を指定します。
     これを libcurl がキャッシュします。
     デフォルトのサイズは、<function>curl_multi_add_handle</function>
     で追加したハンドル数の四倍に収まるように拡大されます。
     キャッシュがいっぱいになると、curl はキャッシュ内で一番古い接続を閉じ、
     開いている接続の数が増えないようにします。
     cURL 7.16.3 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.curlmopt-max-concurrent-streams">
   <term>
    <constant>CURLMOPT_MAX_CONCURRENT_STREAMS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     cURL が HTTP/2 接続でサポートすべき同時ストリームの最大数を指定します。
     有効な値の範囲は <literal>1</literal> から
     <literal>2147483647</literal>（<literal>2^31 - 1</literal>）です。
     ここで指定された値は、
     他のシステムリソースのプロパティに基づいて適用されます。
     デフォルトは <literal>100</literal> です。
     PHP 8.2.0 以降 および cURL 7.67.0. 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.curlmopt-max-host-connections">
   <term>
    <constant>CURLMOPT_MAX_HOST_CONNECTIONS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     単一ホストへの最大接続数を指定します。
     PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.curlmopt-max-pipeline-length">
   <term>
    <constant>CURLMOPT_MAX_PIPELINE_LENGTH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     パイプライン内の最大リクエスト数を指定します。
     PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.curlmopt-max-total-connections">
   <term>
    <constant>CURLMOPT_MAX_TOTAL_CONNECTIONS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     同時に開くことができる、接続の最大数を指定します。
     PHP 7.0.7 以降 および cURL 7.30.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.curlmopt-pipelining">
   <term>
    <constant>CURLMOPT_PIPELINING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     1 を指定するとパイプラインが有効になり、
     0 を指定すると無効になります。
     マルチハンドルでパイプラインを有効にすると、
     このハンドルを使用した転送では可能な限り HTTP パイプラインを実行しようとします。
     これは、既存の接続を利用可能な2つ目のリクエストを追加すると、
     そのリクエストが同じ接続上で "パイプ" されることを意味します。
     cURL 7.43.0 以降、この値はビットマスクとなり、
     2 を渡すと既存の HTTP/2 接続上で新規転送の多重化を試行します。
     3 を渡すと、パイプライン化と多重化を
     互いに独立して要求するよう cURL に指示します。
     cURL 7.62.0 以降は、パイプラインビットを設定しても効果がありません。
     整数リテラルではなく、CURLPIPE_* 定数も使用できます。
     cURL 7.16.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.curlmopt-pushfunction">
   <term>
    <constant>CURLMOPT_PUSHFUNCTION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     サーバープッシュを処理するために登録する <type>callable</type> を渡します。
     これは、以下のシグネチャを持ちます:
     <methodsynopsis>
      <type>int</type><methodname><replaceable>pushfunction</replaceable></methodname>
      <methodparam><type>resource</type><parameter>parent_ch</parameter></methodparam>
      <methodparam><type>resource</type><parameter>pushed_ch</parameter></methodparam>
      <methodparam><type>array</type><parameter>headers</parameter></methodparam>
     </methodsynopsis>
     <variablelist role="function_parameters">
      <varlistentry>
       <term><parameter>parent_ch</parameter></term>
       <listitem>
        <simpara>
         親の cURL ハンドル(クライアントが作成したリクエスト)
        </simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><parameter>pushed_ch</parameter></term>
       <listitem>
        <simpara>
         プッシュされたリクエスト向けの、新しい cURL ハンドル
        </simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><parameter>headers</parameter></term>
       <listitem>
        <simpara>
         push promise のヘッダ
        </simpara>
       </listitem>
      </varlistentry>
     </variablelist>
     プッシュ関数は、プッシュが処理できる場合は、<constant>CURL_PUSH_OK</constant> 
     を返し、拒否する場合は <constant>CURL_PUSH_DENY</constant> を返すことが期待されています。
     PHP 7.1.0 以降 および cURL 7.44.0 以降で利用可能です。
    </para>
   </listitem>
  </varlistentry>
</variablelist>