diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml new file mode 100644 index 0000000000..164ad59f2b --- /dev/null +++ b/reference/curl/constants_curl_setopt.xml @@ -0,0 +1,4635 @@ + + + + <function>curl_setopt</function> + + + CURLOPT_ABSTRACT_UNIX_SOCKET + (int) + + + + ホストへの TCP 接続を確立する代わりに、抽象 Unix ドメインソケットの使用を有効にし、 + 指定された string にパスを設定します。 + このオプションは CURLOPT_UNIX_SOCKET_PATH と同じセマンティクスを共有します。 + これら2つのオプションは同じストレージを共有するため、 + ハンドルごとにいずれか1つしか設定できません。 + Available as of PHP 7.3.0 and cURL 7.53.0. + + + + + + CURLOPT_ACCEPT_ENCODING + (int) + + + + HTTP リクエストで送信される Accept-Encoding: ヘッダの内容を + string で設定します。 + Accept-Encoding: ヘッダの送信を無効にするには &null; を設定します。 + デフォルトは &null; です。 + Available as of cURL 7.21.6. + + + + + + CURLOPT_ACCEPTTIMEOUT_MS + (int) + + + + アクティブ FTP 接続が使用されている場合に、 + サーバーが cURL に接続し返すのを待つ最大ミリ秒数。 + このオプションは有効な int にキャストできる任意の値を受け付けます。 + デフォルトは 60000 ミリ秒です。 + Available as of cURL 7.24.0. + + + + + + CURLOPT_ADDRESS_SCOPE + (int) + + + + IPv6 アドレスに接続する際に使用するスコープ ID 値。 + このオプションは有効な int にキャストできる任意の値を受け付けます。 + デフォルトは 0 です。 + Available as of cURL 7.19.0. + + + + + + CURLOPT_ALTSVC + (int) + + + + cURL が Alt-Svc キャッシュファイルとして使用するファイル名を string で渡します。 + 既存のキャッシュ内容を読み込み、CURLOPT_ALTSVC_CTRL で + CURLALTSVC_READONLYFILE が設定されていない限り、 + 転送後にキャッシュを書き戻す場合があります。 + Available as of PHP 8.2.0 and cURL 7.64.1. + + + + + + CURLOPT_ALTSVC_CTRL + (int) + + + + このハンドルを使用する転送で cURL が Alt-Svc をどのように処理するかを + 指示するために、正しい機能セットでビットマスクを設定します。 + cURL は HTTPS 経由の Alt-Svc ヘッダのみを受け付けます。 + また、代替オリジンが適切に HTTPS でホストされている場合にのみ、 + 代替オリジンへのリクエストを完了します。 + 任意のビットを設定すると、alt-svc エンジンが有効になります。 + CURLALTSVC_* 定数のいずれかに設定します。 + デフォルトでは Alt-Svc 処理は無効です。 + Available as of PHP 8.2.0 and cURL 7.64.1. + + + + + + CURLOPT_APPEND + (int) + + + + このオプションを 1 に設定すると、 + FTP アップロード時にリモートファイルを上書きする代わりに追記します。 + デフォルトは 0 です。 + Available as of cURL 7.17.0. + + + + + + CURLOPT_AUTOREFERER + (int) + + + + &true; を設定すると、Location: リダイレクトに従うリクエストで + Referer: フィールドを自動的に設定します。 + デフォルトは 0 です。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_AWS_SIGV4 + (int) + + + + HTTP(S) ヘッダに AWS V4 署名認証を string として提供します。 + このオプションは、CURLOPT_HTTPAUTH で設定されている + 他の認証タイプを上書きします。 + このメソッドは他の認証タイプと組み合わせることはできません。 + Available as of PHP 8.2.0 and cURL 7.75.0. + + + + + + CURLOPT_BINARYTRANSFER + (int) + + + + この定数は PHP 5.5.0 以降使用されなくなりました。 + PHP 8.4.0 以降非推奨です。 + + + + + + CURLOPT_BUFFERSIZE + (int) + + + + 各読み取りに使用するバッファのサイズ。 + ただし、このリクエストが満たされる保証はありません。 + このオプションは有効な int にキャストできる任意の値を受け付けます。 + デフォルトは CURL_MAX_WRITE_SIZE (現在は 16kB) です。 + Available as of cURL 7.10. + + + + + + CURLOPT_CAINFO + (int) + + + + ピアを検証するための1つ以上の証明書を保持するファイルの名前を + string で指定します。 + これは CURLOPT_SSL_VERIFYPEER と組み合わせて使用する場合にのみ意味があります。 + 絶対パスが必要な場合があります。 + Available as of cURL 7.4.2. + + + + + + CURLOPT_CAINFO_BLOB + (int) + + + + ピアを検証するための1つ以上の証明書を保持する PEM ファイルの名前を + string で指定します。 + このオプションは CURLOPT_CAINFO を上書きします。 + Available as of PHP 8.2.0 and cURL 7.77.0. + + + + + + CURLOPT_CAPATH + (int) + + + + 複数の CA 証明書を保持するディレクトリを string で指定します。 + このオプションは CURLOPT_SSL_VERIFYPEER と併せて使用します。 + Available as of cURL 7.9.8. + + + + + + CURLOPT_CA_CACHE_TIMEOUT + (int) + + + + メモリ内にキャッシュされた CA 証明書ストアを保持し、 + 新しい接続に再利用できる最大時間を秒単位で設定します。 + このオプションは有効な int にキャストできる任意の値を受け付けます。 + デフォルトは 86400 (24 時間) です。 + Available as of PHP 8.3.0 and cURL 7.87.0 + + + + + + CURLOPT_CERTINFO + (int) + + + + &true; を設定すると、セキュアな転送時に SSL 証明書情報を + STDERR に出力します。 + 効果を発揮するには CURLOPT_VERBOSE が有効である必要があります。 + デフォルトは &false; です。 + Available as of cURL 7.19.1. + + + + + + CURLOPT_CONNECTTIMEOUT + (int) + + + + 接続を試みる際に待機する秒数。無期限に待つには 0 を使用します。 + このオプションは有効な int にキャストできる任意の値を受け付けます。 + デフォルトは 300 です。 + Available as of cURL 7.7.0. + + + + + + CURLOPT_CONNECTTIMEOUT_MS + (int) + + + + 接続を試みる際に待機するミリ秒数。 + 無期限に待つには 0 を使用します。 + cURL が標準のシステム名前リゾルバを使用するようにビルドされている場合、 + 接続のその部分は依然としてタイムアウトに秒単位の解像度を使用し、 + 最小タイムアウトは1秒です。 + このオプションは有効な int にキャストできる任意の値を受け付けます。 + デフォルトは 300000 です。 + Available as of cURL 7.16.2. + + + + + + CURLOPT_CONNECT_ONLY + (int) + + + + &true; を設定すると、必要なプロキシ認証と接続セットアップをすべて実行しますが、 + データ転送は行いません。このオプションは HTTP、SMTP、POP3 に対して実装されています。 + デフォルトは &false; です。 + Available as of cURL 7.15.2. + + + + + + CURLOPT_CONNECT_TO + (int) + + + + URL のホストとポートの代わりに、特定のホストとポートに接続します。 + HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT 形式の + string の array を受け付けます。 + Available as of PHP 7.0.7 and cURL 7.49.0. + + + + + + CURLOPT_COOKIE + (int) + + + + HTTP リクエストで使用される Cookie: ヘッダの内容を + string で指定します。 + 複数のクッキーはセミコロンとスペースで区切ります + (例: fruit=apple; colour=red)。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_COOKIEFILE + (int) + + + + クッキーデータを含むファイルの名前を string で指定します。 + クッキーファイルは Netscape 形式、または単純な HTTP スタイルのヘッダを + ファイルにダンプしたものが使用できます。 + 名前が空の string の場合、クッキーは読み込まれませんが、 + クッキー処理は引き続き有効です。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_COOKIEJAR + (int) + + + + ハンドルのデストラクタが呼び出された際に、 + すべての内部クッキーを保存するファイルの名前を string で指定します。 + Available as of cURL 7.9.0. + + + PHP 8.0.0 以降、curl_close は何も行わず、 + ハンドルを破棄しません。 + ハンドルが自動的に破棄される前にクッキーを書き込む必要がある場合は、 + curl_setopt($ch, CURLOPT_COOKIELIST, "FLUSH"); を実行してください。 + + + + + + + + CURLOPT_COOKIELIST + (int) + + + + クッキー string (Netscape/Mozilla 形式の1行、 + または通常の HTTP スタイルの Set-Cookie ヘッダ) を指定すると、 + その単一のクッキーを内部クッキーストアに追加します。 + + + ALL + メモリ内に保持されているすべてのクッキーを消去します + + + SESS + メモリ内に保持されているすべてのセッションクッキーを消去します + + + FLUSH + CURLOPT_COOKIEJAR で指定されたファイルにすべての既知のクッキーを書き込みます + + + RELOAD + CURLOPT_COOKIEFILE で指定されたファイルからすべてのクッキーを読み込みます + + . + Available as of cURL 7.14.1. + + + + + + CURLOPT_COOKIESESSION + (int) + + + + &true; を設定すると、新しいクッキー「セッション」としてマークします。 + これにより、前回のセッションから読み込もうとしている「セッションクッキー」を + cURL がすべて無視するようになります。 + デフォルトでは、cURL はセッションクッキーかどうかに関係なく、 + 常にすべてのクッキーを保存・読み込みます。 + セッションクッキーは有効期限のないクッキーであり、 + この「セッション」の間だけ存在することを意図しています。 + Available as of cURL 7.9.7. + + + + + + CURLOPT_CRLF + (int) + + + + &true; を設定すると、転送時に Unix の改行を CRLF の改行に変換します。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_CRLFILE + (int) + + + + SSL 交換時の証明書検証で使用する CRL (Certificate Revocation List、証明書失効リスト) + を結合した (PEM 形式の) ファイルの名前を string で渡します。 + cURL が GnuTLS を使用するようにビルドされている場合、 + 検証プロセスを補助するために渡された CRL の使用に影響を与える方法はありません。 + cURL が OpenSSL サポートでビルドされている場合、 + X509_V_FLAG_CRL_CHECK と X509_V_FLAG_CRL_CHECK_ALL + の両方が設定され、CRL ファイルが渡された場合は証明書チェーンの + すべての要素に対する CRL チェックが必要になります。 + また、OpenSSL のバグにより、cURL 7.71.0 以降 + CURLOPT_CRLFILE は + CURLSSLOPT_NO_PARTIALCHAIN を暗黙的に指定することに注意してください。 + Available as of cURL 7.19.0. + + + + + + CURLOPT_CUSTOMREQUEST + (int) + + + + HTTP リクエストを行う際に GET や HEAD + の代わりに使用するカスタムリクエストメソッド。 + これは DELETE やその他のあまり一般的ではない HTTP リクエストを + 行う場合に便利です。 + 有効な値は GET、POST、 + CONNECT などです。 + つまり、ここに HTTP リクエスト行全体を入力しないでください。 + 例えば、GET /index.html HTTP/1.0\r\n\r\n と入力するのは + 正しくありません。 + このオプションは string または &null; を受け付けます。 + Available as of cURL 7.1.0. + + + サーバーがカスタムリクエストメソッドをサポートしていることを + 先に確認せずにこれを行わないでください。 + + + + + + + + CURLOPT_DEFAULT_PROTOCOL + (int) + + + + URL にスキーム名がない場合に使用するデフォルトプロトコルを string で指定します。 + Available as of PHP 7.0.7 and cURL 7.45.0. + + + + + + CURLOPT_DIRLISTONLY + (int) + + + + このオプションを 1 に設定すると、 + 使用するプロトコルに応じて異なる効果があります。 + FTP および SFTP ベースの URL では、ディレクトリ内のファイル名のみを一覧表示します。 + POP3 では、POP3 サーバー上のメールメッセージを一覧表示します。 + FILE の場合、このオプションは効果がありません。 + このモードではディレクトリは常に一覧表示されるためです。 + このオプションを CURLOPT_WILDCARDMATCH と共に使用すると、 + 後者が効果を持たなくなります。 + デフォルトは 0 です。 + Available as of cURL 7.17.0. + + + + + + CURLOPT_DISALLOW_USERNAME_IN_URL + (int) + + + + &true; を設定すると、ユーザー名を含む URL を許可しません。 + デフォルトではユーザー名は許可されています。 + Available as of PHP 7.3.0 and cURL 7.61.0. + + + + + + CURLOPT_DNS_CACHE_TIMEOUT + (int) + + + + DNS エントリをメモリに保持する秒数。 + このオプションはデフォルトで 120 (2 分) に設定されています。 + このオプションは有効な int にキャストできる任意の値を受け付けます。 + Available as of cURL 7.9.3. + + + + + + CURLOPT_DNS_INTERFACE + (int) + + + + DNS リゾルバがバインドするネットワークインターフェースの名前を設定します。 + これはインターフェース名でなければなりません (アドレスではありません)。 + このオプションは string または &null; を受け付けます。 + Available as of PHP 7.0.7 and cURL 7.33.0 + + + + + + CURLOPT_DNS_LOCAL_IP4 + (int) + + + + リゾルバがバインドするローカル IPv4 アドレスを設定します。 + 引数には単一の数値 IPv4 アドレスを含める必要があります。 + このオプションは string または &null; を受け付けます。 + Available as of PHP 7.0.7 and cURL 7.33.0. + + + + + + CURLOPT_DNS_LOCAL_IP6 + (int) + + + + リゾルバがバインドするローカル IPv6 アドレスを設定します。 + 引数には単一の数値 IPv6 アドレスを含める必要があります。 + このオプションは string または &null; を受け付けます。 + Available as of PHP 7.0.7 and cURL 7.33.0. + + + + + + CURLOPT_DNS_SERVERS + (int) + + + + システムのデフォルトの代わりに使用する DNS サーバーのカンマ区切りリストを + string で渡します + (例: 192.168.1.100,192.168.1.101:8080)。 + Available as of cURL 7.24.0. + + + + + + CURLOPT_DNS_SHUFFLE_ADDRESSES + (int) + + + + &true; を設定すると、名前が解決されて複数の IP アドレスが返された場合に、 + 返されたすべてのアドレスの順序をシャッフルしてランダムな順序で使用されるようにします。 + これにより、IPv4 が IPv6 より先に使用されたり、その逆が起こる場合があります。 + Available as of PHP 7.3.0 and cURL 7.60.0. + + + + + + CURLOPT_DNS_USE_GLOBAL_CACHE + (int) + + + + &true; を設定すると、グローバル DNS キャッシュを使用します。 + このオプションはスレッドセーフではありません。 + PHP が非スレッド用にビルドされている場合 + (CLI、FCGI、Apache2-Prefork など)、条件付きでデフォルトで有効になっています。 + Available as of cURL 7.9.3 and deprecated as of cURL 7.11.1. + PHP 8.4 以降、このオプションは効果がなくなりました。 + + + + + + CURLOPT_DOH_SSL_VERIFYHOST + (int) + + + + 2 に設定すると、DNS-over-HTTPS サーバーの SSL 証明書の + 名前フィールドをホスト名に対して検証します。 + Available as of PHP 8.2.0 and cURL 7.76.0. + + + + + + CURLOPT_DOH_SSL_VERIFYPEER + (int) + + + + 1 に設定すると有効に、0 に設定すると + DNS-over-HTTPS サーバーの SSL 証明書の真正性の検証を無効にします。 + Available as of PHP 8.2.0 and cURL 7.76.0. + + + + + + CURLOPT_DOH_SSL_VERIFYSTATUS + (int) + + + + 1 に設定すると有効に、0 に設定すると、 + 「Certificate Status Request」TLS 拡張 (OCSP ステープリング) を使用した + DNS-over-HTTPS サーバー証明書のステータス検証を無効にします。 + Available as of PHP 8.2.0 and cURL 7.76.0. + + + + + + CURLOPT_DOH_URL + (int) + + + + DNS-over-HTTPS の URL を提供します。 + このオプションは string または &null; を受け付けます。 + Available as of PHP 8.1.0 and cURL 7.62.0. + + + + + + CURLOPT_EGDSOCKET + (int) + + + + CURLOPT_RANDOM_FILE と似ていますが、 + Entropy Gathering Daemon ソケットへのファイル名を指定します。 + Available as of cURL 7.7.0 and deprecated as of cURL 7.84.0. + + + + + + CURLOPT_ENCODING + (int) + + + + Accept-Encoding: ヘッダの内容を string で指定します。 + これによりレスポンスのデコードが有効になります。サポートされるエンコーディングは + + identity + deflate + gzip + です。 + 空の string を設定すると、 + サポートされるすべてのエンコーディングタイプを含むヘッダが送信されます。 + Available as of cURL 7.10 and deprecated as of cURL 7.21.6. + + + + + + CURLOPT_EXPECT_100_TIMEOUT_MS + (int) + + + + Expect: 100-continue レスポンスのタイムアウト (ミリ秒単位)。 + デフォルトは 1000 ミリ秒です。 + このオプションは有効な int にキャストできる任意の値を受け付けます。 + Available as of PHP 7.0.7 and cURL 7.36.0. + + + + + + CURLOPT_FAILONERROR + (int) + + + + &true; を設定すると、返された HTTP コードが 400 以上の場合に + 詳細なエラーで失敗します。 + デフォルトの動作はコードを無視してページを通常通り返すことです。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_FILE + (int) + + + + 転送の書き込み先となるファイルのファイルハンドル resource を受け付けます。 + デフォルトは STDOUT (ブラウザウィンドウ) です。 + Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7. + + + + + + CURLOPT_FILETIME + (int) + + + + &true; に設定すると、リモートドキュメントの更新日時の取得を試みます。 + この値は curl_getinfo の + CURLINFO_FILETIME オプションで取得できます。 + Available as of cURL 7.5.0. + + + + + + CURLOPT_FNMATCH_FUNCTION + (int) + + + + ワイルドカードマッチングに使用される callable を渡します。 + コールバックのシグネチャは以下の通りです: + + intcallback + resourcecurlHandle + stringpattern + stringstring + + + + curlHandle + + + cURL ハンドル。 + + + + + pattern + + + ワイルドカードパターン。 + + + + + string + + + ワイルドカードパターンマッチングを実行する対象の string。 + + + + + コールバックは、パターンが string に一致する場合は + CURL_FNMATCHFUNC_MATCH を、 + 一致しない場合は CURL_FNMATCHFUNC_NOMATCH を、 + エラーが発生した場合は CURL_FNMATCHFUNC_FAIL を返す必要があります。 + Available as of cURL 7.21.0. + + + + + + CURLOPT_FOLLOWLOCATION + (int) + + + + &true; に設定すると、サーバーが HTTP ヘッダの一部として送信する + Location: ヘッダに従います。 + CURLOPT_MAXREDIRS も参照してください。 + この定数は open_basedir + が有効な場合は使用できません。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_FORBID_REUSE + (int) + + + + &true; に設定すると、処理が完了した際に接続を明示的に閉じ、 + 再利用のためにプールしないようにします。 + Available as of cURL 7.7.0. + + + + + + CURLOPT_FRESH_CONNECT + (int) + + + + &true; に設定すると、キャッシュされた接続の代わりに + 新しい接続の使用を強制します。 + Available as of cURL 7.7.0. + + + + + + CURLOPT_FTPAPPEND + (int) + + + + &true; に設定すると、リモートファイルを上書きする代わりに追記します。 + Available as of cURL 7.1.0 and deprecated as of cURL 7.16.4. + + + + + + CURLOPT_FTPASCII + (int) + + + + CURLOPT_TRANSFERTEXT のエイリアス。 + 代わりにそちらを使用してください。 + Available as of cURL 7.1, deprecated as of cURL 7.11.1 + and last available in cURL 7.15.5. + PHP 7.3.0 で削除されました。 + + + + + + CURLOPT_FTPLISTONLY + (int) + + + + &true; に設定すると、FTP ディレクトリのファイル名のみを一覧表示します。 + Available as of cURL 7.1.0 and deprecated as of cURL 7.16.4. + + + + + + CURLOPT_FTPPORT + (int) + + + + FTP の PORT 命令に使用する IP アドレスを取得するために使用される + string。PORT 命令は、指定した IP アドレスに + リモートサーバーが接続するよう指示します。 + string にはプレーンな IP アドレス、ホスト名、 + ネットワークインターフェース名 (Unix の場合)、 + またはシステムのデフォルト IP アドレスを使用するための + 単なる - を指定できます。 + このオプションは string または &null; を受け付けます。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_FTPSSLAUTH + (int) + + + + FTP over SSL の認証方式 (有効な場合) を + CURLFTPAUTH_* 定数のいずれかに設定します。 + デフォルトは CURLFTPAUTH_DEFAULT です。 + Available as of cURL 7.12.2. + + + + + + CURLOPT_FTP_ACCOUNT + (int) + + + + ユーザー名とパスワードがサーバーに提供された後、 + FTP 経由で (ACCT コマンドを使用して) + アカウント情報として送信される string を渡します。 + アカウント情報の送信を無効にするには &null; を設定します。 + デフォルトは &null; です。 + Available as of cURL 7.13.0. + + + + + + CURLOPT_FTP_ALTERNATIVE_TO_USER + (int) + + + + USER/PASS ネゴシエーションが失敗した場合に + FTP 認証を試みるために使用される string を渡します。 + Available as of cURL 7.15.5. + + + + + + CURLOPT_FTP_CREATE_MISSING_DIRS + (int) + + + + FTP 操作中に現在存在しないパスに遭遇した場合に、 + 不足しているディレクトリを作成するには &true; を設定します。 + Available as of cURL 7.10.7. + + + + + + CURLOPT_FTP_FILEMETHOD + (int) + + + + FTP(S) サーバー上のファイルに到達するために使用するメソッドを cURL に指示します。 + 指定可能な値は CURLFTPMETHOD_* 定数のいずれかです。 + デフォルトは CURLFTPMETHOD_MULTICWD です。 + Available as of cURL 7.15.1. + + + + + + CURLOPT_FTP_RESPONSE_TIMEOUT + (int) + + + + FTP サーバーからのレスポンスを cURL が待機するタイムアウト（秒単位）。 + このオプションは CURLOPT_TIMEOUT を上書きします。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + このオプション名は CURLOPT_SERVER_RESPONSE_TIMEOUT に置き換えられました。 + PHP 8.4.0 以降で利用可能です。 + Available as of cURL 7.10.8 and deprecated as of cURL 7.85.0. + + + + + + CURLOPT_FTP_SKIP_PASV_IP + (int) + + + + このオプションを 1 に設定すると、 + cURL は、サーバーが cURL の PASV コマンドに対する + 227 レスポンスで提示した IP アドレスを使用せず、 + 接続に使用した IP アドレスを使用します。 + 227 レスポンスで受信したポート番号は cURL によって無視されません。 + cURL 7.74.0 以降のデフォルトは 1、 + それ以前は 0 です。 + Available as of cURL 7.15.0. + + + + + + CURLOPT_FTP_SSL + (int) + + + + Available as of cURL 7.11.0 and deprecated as of cURL 7.16.4. + + + + + + CURLOPT_FTP_SSL_CCC + (int) + + + + このオプションは cURL に CCC (Clear Command Channel) を使用させます。 + これは認証後に SSL/TLS レイヤーをシャットダウンし、 + 残りのコントロールチャネル通信を暗号化されていない状態にします。 + CURLFTPSSL_CCC_* 定数のいずれかを使用します。 + デフォルトは CURLFTPSSL_CCC_NONE です。 + Available as of cURL 7.16.1. + + + + + + CURLOPT_FTP_USE_EPRT + (int) + + + + アクティブ FTP ダウンロード時に EPRT（および LPRT）を使用するには &true; を設定します。 + EPRT と LPRT を無効にして PORT のみを使用するには &false; を設定します。 + Available as of cURL 7.10.5. + + + + + + CURLOPT_FTP_USE_EPSV + (int) + + + + FTP 転送で最初に EPSV コマンドを試行し、失敗した場合に PASV に戻すには &true; を設定します。 + EPSV を無効にするには &false; を設定します。 + Available as of cURL 7.9.2. + + + + + + CURLOPT_FTP_USE_PRET + (int) + + + + PASV（および EPSV）の前に + PRET コマンドを送信するには 1 を設定します。 + アクティブ FTP 転送モードを使用している場合は効果がありません。 + デフォルトは 0 です。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_GSSAPI_DELEGATION + (int) + + + + 無条件の GSSAPI 資格情報委任を許可するには + CURLGSSAPI_DELEGATION_FLAG を設定します。 + サービスチケットに OK-AS-DELEGATE フラグが設定されている場合にのみ + 委任するには CURLGSSAPI_DELEGATION_POLICY_FLAG を設定します。 + デフォルトは CURLGSSAPI_DELEGATION_NONE です。 + Available as of cURL 7.22.0. + + + + + + CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS + (int) + + + + Happy Eyeballs アルゴリズムにおける IPv6 のヘッドスタート。Happy Eyeballs は、 + デュアルスタックホストに対して IPv4 と IPv6 の両方のアドレスへの接続を試み、 + 指定ミリ秒の間 IPv6 を優先します。 + デフォルトは CURL_HET_DEFAULT で、現在は 200 ミリ秒です。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of PHP 7.3.0 and cURL 7.59.0 + + + + + + CURLOPT_HAPROXYPROTOCOL + (int) + + + + 接続の開始時に HAProxy PROXY プロトコル v1 ヘッダを送信するには &true; を設定します。 + デフォルトの動作はこのヘッダを送信しません。 + Available as of PHP 7.3.0 and cURL 7.60.0. + + + + + + CURLOPT_HEADER + (int) + + + + CURLOPT_WRITEFUNCTION で定義されたコールバックに送信される出力にヘッダを含めるには + &true; を設定します。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_HEADERFUNCTION + (int) + + + + 以下のシグネチャを持つ callable: + + intcallback + resourcecurlHandle + stringheaderData + + + + curlHandle + + + cURL ハンドル。 + + + + + headerData + + + コールバックによって書き込まれるヘッダデータ。 + + + + + コールバックは書き込んだバイト数を返す必要があります。 + Available as of cURL 7.7.2. + + + + + + CURLOPT_HEADEROPT + (int) + + + + HTTP ヘッダをプロキシとホストの両方に送信するか、個別に送信するかを設定します。 + 指定可能な値は + CURLHEADER_* 定数のいずれかです。 + cURL 7.42.1 以降のデフォルトは CURLHEADER_SEPARATE、 + それ以前は CURLHEADER_UNIFIED です。 + Available as of PHP 7.0.7 and cURL 7.37.0. + + + + + + CURLOPT_HSTS + (int) + + + + HSTS (HTTP Strict Transport Security) キャッシュファイル名の string、 + またはファイルの読み書きなしで HSTS を許可し、 + HSTS データを読み取るファイルのリストをクリアするには &null; を指定します。 + Available as of PHP 8.2.0 and cURL 7.74.0. + + + + + + CURLOPT_HSTS_CTRL + (int) + + + + CURLHSTS_* 定数で定義される + HSTS (HTTP Strict Transport Security) 機能のビットマスクを受け付けます。 + Available as of PHP 8.2.0 and cURL 7.74.0. + + + + + + CURLOPT_HTTP09_ALLOWED + (int) + + + + HTTP/0.9 レスポンスを許可するかどうかを指定します。cURL 7.66.0 以降のデフォルトは &false; です。 + 以前のデフォルトは &true; でした。 + Available as of PHP 7.3.15 and 7.4.3, respectively, and cURL 7.64.0. + + + + + + CURLOPT_HTTP200ALIASES + (int) + + + + エラーではなく有効なレスポンスとして扱われる HTTP 200 レスポンスの array。 + Available as of cURL 7.10.3. + + + + + + CURLOPT_HTTPAUTH + (int) + + + + 使用する HTTP 認証方式のビットマスク。オプションは以下の通りです: + + CURLAUTH_BASIC + CURLAUTH_DIGEST + CURLAUTH_GSSNEGOTIATE + CURLAUTH_NTLM + CURLAUTH_AWS_SIGV4 + CURLAUTH_ANY + CURLAUTH_ANYSAFE + . + 複数の方式が使用された場合、cURL はサーバーにポーリングして + サポートされている方式を確認し、最適な方式を選択します。 + CURLAUTH_ANY はすべてのビットを設定します。cURL は + 最も安全と判断した方式を自動的に選択します。 + CURLAUTH_ANYSAFE は CURLAUTH_BASIC を除くすべてのビットを設定します。 + cURL は最も安全と判断した方式を自動的に選択します。 + Available as of cURL 7.10.6. + + + + + + CURLOPT_HTTPGET + (int) + + + + HTTP リクエストメソッドを GET にリセットするには &true; を設定します。GET はデフォルトであるため、 + リクエストメソッドが変更された場合にのみ必要です。 + Available as of cURL 7.8.1. + + + + + + CURLOPT_HTTPHEADER + (int) + + + + 設定する HTTP ヘッダフィールドの array。フォーマットは + + array('Content-type: text/plain', 'Content-length: 100') + + Available as of cURL 7.1.0. + + + + + + CURLOPT_HTTPPROXYTUNNEL + (int) + + + + 指定された HTTP プロキシを通じてトンネリングするには &true; を設定します。 + Available as of cURL 7.3.0. + + + + + + CURLOPT_HTTP_CONTENT_DECODING + (int) + + + + 生の HTTP レスポンスボディを取得するには &false; を設定します。 + Available as of cURL 7.16.2. + + + + + + CURLOPT_HTTP_TRANSFER_DECODING + (int) + + + + 0 に設定すると、転送デコーディングが無効になります。 + 1 に設定すると、転送デコーディングが有効になります。 + このオプションを 0 に設定しない限り、 + cURL はデフォルトでチャンク転送デコーディングを行います。 + デフォルトは 1 です。 + Available as of cURL 7.16.2. + + + + + + CURLOPT_HTTP_VERSION + (int) + + + + cURL が指定された HTTP バージョンを使用するように、 + CURL_HTTP_VERSION_* 定数のいずれかを設定します。 + Available as of cURL 7.9.1. + + + + + + CURLOPT_IGNORE_CONTENT_LENGTH + (int) + + + + 1 に設定すると、 + HTTP レスポンスの Content-Length ヘッダを無視し、 + FTP 転送でのその要求や依存も無視します。 + デフォルトは 0 です。 + Available as of cURL 7.14.1. + + + + + + CURLOPT_INFILE + (int) + + + + アップロード時に転送の読み取り元となるファイルのファイルハンドル resource を受け付けます。 + Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7. + 代わりに CURLOPT_READDATA を使用してください。 + + + + + + CURLOPT_INFILESIZE + (int) + + + + リモートサイトにファイルをアップロードする際の、予想されるファイルサイズ（バイト単位）。 + このオプションを使用しても、cURL がより多くのデータを送信するのを防ぐことはできません。 + 実際に送信される内容は CURLOPT_READFUNCTION に依存します。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_INTERFACE + (int) + + + + 使用する送信ネットワークインターフェース名の string を設定します。 + インターフェース名、IP アドレス、またはホスト名を指定できます。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_IPRESOLVE + (int) + + + + ホスト名の解決時に使用する IP アドレスの種類をアプリケーションが選択できるようにします。 + これは、複数のバージョンの IP を使用してアドレスを解決するホスト名を使用する場合にのみ重要です。 + CURL_IPRESOLVE_* 定数のいずれかを設定します。 + デフォルトは CURL_IPRESOLVE_WHATEVER です。 + Available as of cURL 7.10.8. + + + + + + CURLOPT_ISSUERCERT + (int) + + + + PEM 形式の CA 証明書を保持するファイル名の string を設定すると、 + ピア証明書に対して追加のチェックが行われ、 + 発行者がこのオプションで提供された証明書に関連付けられているものであるかを検証します。 + チェック結果を失敗と見なすには、 + このオプションを CURLOPT_SSL_VERIFYPEER オプションと + 組み合わせて使用する必要があります。 + Available as of cURL 7.19.0. + + + + + + CURLOPT_ISSUERCERT_BLOB + (int) + + + + PEM 形式の CA SSL 証明書のバイナリデータを含む string を渡します。 + 設定すると、ピア証明書に対して追加のチェックが行われ、 + 発行者がこのオプションで提供された証明書に関連付けられているものであるかを検証します。 + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_KEEP_SENDING_ON_ERROR + (int) + + + + 返された HTTP コードが 300 以上の場合でもリクエストボディの送信を続けるには &true; を設定します。 + デフォルトの動作は送信を停止してストリームまたは接続を閉じます。 + 手動 NTLM 認証に適しています。 + ほとんどのアプリケーションではこのオプションは不要です。 + Available as of PHP 7.3.0 and cURL 7.51.0. + + + + + + CURLOPT_KEYPASSWD + (int) + + + + CURLOPT_SSLKEY または CURLOPT_SSH_PRIVATE_KEYFILE + の秘密鍵を使用するために必要なパスワードの string を設定します。 + このオプションを &null; に設定すると、これらのオプションのパスワード使用が無効になります。 + Available as of cURL 7.17.0. + + + + + + CURLOPT_KRB4LEVEL + (int) + + + + KRB4 (Kerberos 4) セキュリティレベル。以下の string 値のいずれか + （弱い順から強い順）が有効です: + + clear + safe + confidential + private + . + string がこれらのいずれにも一致しない場合、 + private が使用されます。このオプションを &null; に設定すると、 + KRB4 セキュリティが無効になります。現在、KRB4 セキュリティは + FTP トランザクションでのみ機能します。 + Available as of cURL 7.3.0 and deprecated as of cURL 7.17.0. + + + + + + CURLOPT_KRBLEVEL + (int) + + + + FTP の Kerberos セキュリティレベルを設定し、Kerberos 認識も有効にします。 + 以下の string のいずれかに設定する必要があります: + + clear + safe + confidential + private + . + string が設定されているがこれらのいずれにも一致しない場合、 + private が使用されます。 + このオプションを &null; に設定すると、FTP の Kerberos サポートが無効になります。 + デフォルトは &null; です。 + Available as of cURL 7.16.4. + + + + + + CURLOPT_LOCALPORT + (int) + + + + 接続に使用するソケットのローカルポート番号を設定します。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルトは 0 です。 + Available as of cURL 7.15.2. + + + + + + CURLOPT_LOCALPORTRANGE + (int) + + + + CURLOPT_LOCALPORT で設定されたポート番号から開始して、 + cURL が使用可能なローカルポート番号を見つけるために試行する回数。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルトは 1 です。 + Available as of cURL 7.15.2. + + + + + + CURLOPT_LOGIN_OPTIONS + (int) + + + + AUTH=NTLM や AUTH=* などの + 優先認証メカニズムのようなプロトコル固有のログインオプションを設定するために使用できます。 + CURLOPT_USERNAME オプションと併用する必要があります。 + Available as of PHP 7.0.7 and cURL 7.34.0. + + + + + + CURLOPT_LOW_SPEED_LIMIT + (int) + + + + CURLOPT_LOW_SPEED_TIME の秒数の間、 + 転送速度がこの値（バイト毎秒）を下回った場合に、 + PHP が転送が遅すぎると判断して中断する転送速度。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_LOW_SPEED_TIME + (int) + + + + 転送速度が CURLOPT_LOW_SPEED_LIMIT を下回っている秒数。 + この期間を超えると、PHP は転送が遅すぎると判断して中断します。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_MAIL_AUTH + (int) + + + + 別のサーバーにリレーされている送信メッセージの認証アドレス（アイデンティティ）の + string を設定します。 + アドレスは山括弧（<>）で囲んで指定すべきではありません。 + 空の string が使用された場合、RFC 2554 で要求されるように + cURL が山括弧のペアを送信します。 + Available as of cURL 7.25.0. + + + + + + CURLOPT_MAIL_FROM + (int) + + + + SMTP メール送信時の送信者のメールアドレスの string を設定します。 + メールアドレスは山括弧（<>）で囲んで指定する必要があり、 + 指定されていない場合は自動的に追加されます。 + このパラメータが指定されていない場合、空のアドレスが + SMTP サーバーに送信され、メールが拒否される可能性があります。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_MAIL_RCPT + (int) + + + + SMTP メールリクエストでサーバーに渡す受信者の string の array を設定します。 + 各受信者は山括弧（<>）で囲んで指定する必要があります。 + 山括弧が最初の文字として使用されていない場合、 + cURL は単一のメールアドレスが提供されたと見なし、 + そのアドレスを括弧で囲みます。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_MAIL_RCPT_ALLLOWFAILS + (int) + + + + 一部の受信者に対する RCPT TO コマンドの失敗を許可するには + 1 を設定します。これにより cURL は個々の受信者のエラーを無視し、 + 残りの受け入れられた受信者で処理を続行します。 + すべての受信者がエラーを引き起こし、このフラグが指定されている場合、 + cURL は SMTP の通信を中断し、 + 最後の RCPT TO コマンドから受信したエラーを返します。 + cURL 8.2.0 以降は CURLOPT_MAIL_RCPT_ALLOWFAILS に置き換えられました。 + Available as of PHP 8.2.0 and cURL 7.69.0. + Deprecated as of cURL 8.2.0. + + + + + + CURLOPT_MAXAGE_CONN + (int) + + + + 既存の接続が再利用の対象と見なされるために許可される最大アイドル時間。 + デフォルトの最大年齢は 118 秒に設定されています。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of PHP 8.2.0 and cURL 7.65.0. + + + + + + CURLOPT_MAXCONNECTS + (int) + + + + 許可される永続的接続の最大数。 + 制限に達すると、開いている接続の数が増加しないように、 + キャッシュ内の最も古い接続が閉じられます。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of cURL 7.7.0. + + + + + + CURLOPT_MAXFILESIZE + (int) + + + + ダウンロードするファイルの最大許容サイズ（バイト単位）を設定します。 + 要求されたファイルがこの値より大きい場合、 + 転送は中断され、CURLE_FILESIZE_EXCEEDED が返されます。 + 0 を渡すとこのオプションが無効になり、 + 負のサイズを渡すと CURLE_BAD_FUNCTION_ARGUMENT が返されます。 + ダウンロード開始前にファイルサイズが不明な場合、 + このオプションは効果がありません。 + 2GB を超えるサイズ制限を設定するには、 + CURLOPT_MAXFILESIZE_LARGE を使用してください。 + cURL 8.4.0 以降、このオプションはこのしきい値に達した + 進行中の転送も停止します。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルトは 0 です。 + Available as of cURL 7.10.8. + + + + + + CURLOPT_MAXFILESIZE_LARGE + (int) + + + + ダウンロードが許可される最大ファイルサイズ（バイト単位）。要求されたファイルがこの値より大きい場合、 + 転送は開始されず、CURLE_FILESIZE_EXCEEDED が返されます。 + ファイルサイズはダウンロード前に常に判明しているわけではなく、そのようなファイルの場合、 + ファイル転送がこの制限を超えてもこのオプションは効果がありません。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of PHP 8.2.0 and cURL 7.11.0. + + + + + + CURLOPT_MAXLIFETIME_CONN + (int) + + + + 接続の作成時点からの最大時間（秒単位）で、既存の接続が再利用の対象と見なされるために + 許可されます。キャッシュ内でこの値より古い接続が見つかった場合、 + 進行中の転送が完了した後に閉じられます。 + デフォルトは 0 秒で、オプションが無効であり、すべての接続が再利用の対象であることを意味します。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of PHP 8.2.0 and cURL 7.80.0. + + + + + + CURLOPT_MAXREDIRS + (int) + + + + 追従する HTTP リダイレクトの最大数。このオプションは CURLOPT_FOLLOWLOCATION と併用してください。 + 無限リダイレクトを防ぐため、デフォルト値は 20 に設定されています。 + -1 に設定すると無限リダイレクトを許可し、0 に設定するとすべてのリダイレクトを拒否します。 + Available as of cURL 7.5.0. + + + + + + CURLOPT_MAX_RECV_SPEED_LARGE + (int) + + + + 転送中の累積平均でこの速度（バイト毎秒）を超えるダウンロードの場合、 + 平均速度がパラメータ値以下になるように転送が一時停止されます。 + デフォルトは無制限の速度です。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of cURL 7.15.5. + + + + + + CURLOPT_MAX_SEND_SPEED_LARGE + (int) + + + + 転送中の累積平均でこの速度（バイト毎秒）を超えるアップロードの場合、 + 平均速度がパラメータ値以下になるように転送が一時停止されます。 + デフォルトは無制限の速度です。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of cURL 7.15.5. + + + + + + CURLOPT_MIME_OPTIONS + (int) + + + + CURLMIMEOPT_* 定数のビットマスクを設定します。 + 現在利用可能なオプションは CURLMIMEOPT_FORMESCAPE のみです。 + Available as of PHP 8.3.0 and cURL 7.81.0. + + + + + + CURLOPT_MUTE + (int) + + + + cURL 関数に関して完全にサイレントにするには &true; を設定します。 + 代わりに CURLOPT_RETURNTRANSFER を使用してください。 + Available as of cURL 7.1.0, deprecated as of cURL 7.8.0 + and last available in cURL 7.15.5. + Removed as of PHP 7.3.0. + + + + + + CURLOPT_NETRC + (int) + + + + 接続を確立するリモートサイトのユーザー名とパスワードを + ~/.netrc ファイルからスキャンするには &true; を設定します。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_NETRC_FILE + (int) + + + + .netrc ファイルのフルパス名を含む string を設定します。 + このオプションが省略され、CURLOPT_NETRC が設定されている場合、 + cURL は現在のユーザーのホームディレクトリで .netrc ファイルを確認します。 + Available as of cURL 7.11.0. + + + + + + CURLOPT_NEW_DIRECTORY_PERMS + (int) + + + + リモートサーバー上に新しく作成されるディレクトリに設定されるパーミッション（int）の値を設定します。 + デフォルト値は 0755 です。 + このオプションを使用できるプロトコルは + sftp://、scp://、 + および file:// のみです。 + Available as of cURL 7.16.4. + + + + + + CURLOPT_NEW_FILE_PERMS + (int) + + + + リモートサーバー上に新しく作成されるファイルに設定されるパーミッション（int）の値を設定します。 + デフォルト値は 0644 です。 このプロトコルを使用できるのは + sftp://、scp://、 + および file:// のみです。 + Available as of cURL 7.16.4. + + + + + + CURLOPT_NOBODY + (int) + + + + 出力からボディを除外するには &true; に設定します。 + HTTP(S) の場合、cURL は HEAD リクエストを行います。その他のほとんどのプロトコルでは、 + cURL はボディデータをまったく要求しません。 + これを &false; に変更すると、出力にボディデータが含まれるようになります。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_NOPROGRESS + (int) + + + + cURL 転送のプログレスメーターを無効にするには &true; に設定します。 + + + PHP はこのオプションを自動的に &true; に設定します。 + デバッグ目的でのみ変更してください。 + + + Available as of cURL 7.1.0. + + + + + + CURLOPT_NOPROXY + (int) + + + + プロキシを使用せずにアクセスできるホスト名のカンマ区切りリストを含む + string を設定します。 + このリスト内の各名前は、ホスト名を含むドメイン、 + またはホスト名そのものとしてマッチします。 + この string で使用可能な唯一のワイルドカードは + 単一の * 文字で、すべてのホストにマッチし、 + 事実上プロキシを無効にします。 + このオプションを空の string に設定すると、すべてのホスト名に対してプロキシが有効になります。 + cURL 7.86.0 以降、このオプションで設定する IP アドレスには + CIDR 表記が使用できます。 + Available as of cURL 7.19.4. + + + + + + CURLOPT_NOSIGNAL + (int) + + + + PHP プロセスにシグナルを送信する cURL 関数を無視するには + &true; に設定します。マルチスレッド SAPI ではデフォルトで有効になっており、 + タイムアウトオプションを引き続き使用できます。 + Available as of cURL 7.10. + + + + + + CURLOPT_PASSWDFUNCTION + (int) + + + + 次のシグネチャを持つ callable: + + stringcallback + resourcecurlHandle + stringpasswordPrompt + intmaximumPasswordLength + + + + curlHandle + + + cURL ハンドル。 + + + + + passwordPrompt + + + パスワードプロンプト。 + + + + + maximumPasswordLength + + + パスワードの最大長。 + + + + + コールバックはパスワードを含む string を返す必要があります。 + Available as of cURL 7.4.2, deprecated as of cURL 7.11.1 + and last available in cURL 7.15.5. + Removed as of PHP 7.3.0. + + + + + + CURLOPT_PASSWORD + (int) + + + + 認証に使用するパスワードの string を設定します。 + Available as of cURL 7.19.1. + + + + + + CURLOPT_PATH_AS_IS + (int) + + + + cURL がサーバーに渡す前に URL パスを変更しないようにするには &true; に設定します。 + デフォルトは &false; で、RFC 3986 セクション 5.2.4 に従って + 削除されるべき URL のパス部分に存在する /../ + や /./ のシーケンスを圧縮します。 + Available as of PHP 7.0.7 and cURL 7.42.0. + + + + + + CURLOPT_PINNEDPUBLICKEY + (int) + + + + ピン留めされた公開鍵の string を設定します。 + string は PEM または DER ファイル形式のピン留めされた公開鍵の + ファイル名にすることができます。string はまた、 + sha256// を先頭に付けて ; + で区切られた、任意の数の base64 エンコードされた sha256 ハッシュにすることもできます。 + Available as of PHP 7.0.7 and cURL 7.39.0. + + + + + + CURLOPT_PIPEWAIT + (int) + + + + 新しい接続を作成して使用する前に、既存の接続が多重化可能かどうかを確認し、 + 可能であればそれを使用するように待機するには &true; に設定します。 + Available as of PHP 7.0.7 and cURL 7.43.0. + + + + + + CURLOPT_PORT + (int) + + + + URL で指定されたポートや使用するプロトコルのデフォルトポートの代わりに + 接続する代替ポート番号の int。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_POST + (int) + + + + HTTP POST リクエストを行うには &true; に設定します。 + このリクエストは application/x-www-form-urlencoded ヘッダーを使用します。 + デフォルトは &false; です。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_POSTFIELDS + (int) + + + + HTTP POST 操作でポストする全データ。 + このパラメータは、'para1=val1&para2=val2&...' + のような URL エンコードされた string、 + またはフィールド名をキー、フィールドデータを値とする array として渡すことができます。 + value が array の場合、 + Content-Type ヘッダーは + multipart/form-data に設定されます。 + ファイルは CURLFile または CURLStringFile を使用して送信でき、 + その場合 value は array でなければなりません。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_POSTQUOTE + (int) + + + + FTP リクエスト実行後にサーバー上で実行する FTP コマンド string の + array。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_POSTREDIR + (int) + + + + CURLOPT_FOLLOWLOCATION が設定されていて + 特定の種類のリダイレクトが発生した場合に HTTP POST メソッドを + 維持する必要がある場合は、CURL_REDIR_POST_301、 + CURL_REDIR_POST_302、および CURL_REDIR_POST_303 + のビットマスクに設定します。 + Available as of cURL 7.19.1. + + + + + + CURLOPT_PRE_PROXY + (int) + + + + 次のリクエストで CURLOPT_PROXY オプションで指定された + HTTP(S) プロキシに接続する前に cURL が接続するプリプロキシとして使用する + ホスト名またはドット付き数値 IP アドレスを保持する string を設定します。 + プリプロキシは SOCKS プロキシのみ使用可能で、使用する SOCKS の種類を指定するために + [scheme]:// をプレフィックスとして付ける必要があります。 + 数値の IPv6 アドレスは [brackets] 内に記述する必要があります。 + プリプロキシを空の string に設定すると、プリプロキシの使用が明示的に無効になります。 + この string でポート番号を指定するには、ホスト名の末尾に :[port] + を追加します。プロキシのポート番号は、別のオプション + CURLOPT_PROXYPORT で指定することもできます。 + ポートが指定されていない場合、プロキシのデフォルトポート 1080 を使用します。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PREQUOTE + (int) + + + + 転送タイプが設定された後にサーバーに渡す FTP コマンド string の + array を設定します。 + これらのコマンドはディレクトリ一覧の取得時には実行されず、 + ファイル転送時にのみ実行されます。 + Available as of cURL 7.9.5. + + + + + + CURLOPT_PRIVATE + (int) + + + + この cURL ハンドルに関連付けるべき任意のデータ。このデータは、 + 後で curl_getinfo の + CURLINFO_PRIVATE オプションを使用して取得できます。 + cURL はこのデータに対して何も行いません。 + cURL マルチハンドルを使用する場合、このプライベートデータは通常、 + 標準の cURL ハンドルを識別するための一意のキーです。 + Available as of cURL 7.10.3. + + + + + + CURLOPT_PROGRESSFUNCTION + (int) + + + + 次のシグネチャを持つ callable: + + intcallback + resourcecurlHandle + intbytesToDownload + intbytesDownloaded + intbytesToUpload + intbytesUploaded + + + + curlHandle + + + cURL ハンドル。 + + + + + bytesToDownload + + + この転送でダウンロードが予想される合計バイト数。 + + + + + bytesDownloaded + + + これまでにダウンロードされたバイト数。 + + + + + bytesToUpload + + + この転送でアップロードが予想される合計バイト数。 + + + + + bytesUploaded + + + これまでにアップロードされたバイト数。 + + + + + コールバックは転送を中止して CURLE_ABORTED_BY_CALLBACK エラーを設定するために + ゼロ以外の値の int を返す必要があります。 + + + コールバックは CURLOPT_NOPROGRESS + オプションが &false; に設定されている場合にのみ呼び出されます。 + + + Available as of cURL 7.1.0 and deprecated as of cURL 7.32.0. + Use CURLOPT_XFERINFOFUNCTION instead. + + + + + + CURLOPT_PROTOCOLS + (int) + + + + CURLPROTO_* 値のビットマスク。 + 使用すると、このビットマスクは cURL が転送で使用するプロトコルを制限します。 + デフォルトは CURLPROTO_ALL、 + つまり cURL はサポートするすべてのプロトコルを受け入れます。 + CURLOPT_REDIR_PROTOCOLS も参照してください。 + Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0. + + + + + + CURLOPT_PROTOCOLS_STR + (int) + + + + 転送で許可する大文字小文字を区別しないプロトコル名（URL スキーム）の + カンマ区切りリストの string を設定します。 + すべてのプロトコルを有効にするには ALL を設定します。 + デフォルトでは、cURL はサポートしてビルドされたすべてのプロトコルを受け入れます。 + 利用可能なプロトコルは次のとおりです: + + DICT + FILE + FTP + FTPS + GOPHER + GOPHERS + HTTP + HTTPS + IMAP + IMAPS + LDAP + LDAPS + MQTT + POP3 + POP3S + RTMP + RTMPE + RTMPS + RTMPT + RTMPTE + RTMPTS + RTSP + SCP + SFTP + SMB + SMBS + SMTP + SMTPS + TELNET + TFTP + WS + WSS + . + Available as of PHP 8.3.0 and cURL 7.85.0. + + + + + + CURLOPT_PROXY + (int) + + + + リクエストをトンネリングする HTTP プロキシの string。 + ホスト名、ドット付き数値 IP アドレス、 + または [brackets] 内に記述された数値 IPv6 アドレスを指定します。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_PROXYAUTH + (int) + + + + プロキシ接続に使用する HTTP 認証方式 + （CURLAUTH_* 定数）のビットマスク。 + プロキシ認証には、現在 CURLAUTH_BASIC と + CURLAUTH_NTLM のみがサポートされています。 + デフォルトは CURLAUTH_BASIC です。 + Available as of cURL 7.10.7. + + + + + + CURLOPT_PROXYHEADER + (int) + + + + プロキシに渡すカスタム HTTP ヘッダー string の array。 + Available as of PHP 7.0.7 and cURL 7.37.0. + + + + + + CURLOPT_PROXYPASSWORD + (int) + + + + プロキシとの認証に使用するパスワードの string を設定します。 + Available as of cURL 7.19.1. + + + + + + CURLOPT_PROXYPORT + (int) + + + + 接続するプロキシのポート番号の int。 + このポート番号は CURLOPT_PROXY でも設定できます。 + これをゼロに設定すると、cURL はデフォルトのプロキシポート番号、 + またはプロキシ URL string で指定されたポート番号を使用します。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_PROXYTYPE + (int) + + + + プロキシのタイプを + CURLPROXY_* 定数のいずれかに設定します。 + デフォルトは CURLPROXY_HTTP です。 + Available as of cURL 7.10. + + + + + + CURLOPT_PROXYUSERNAME + (int) + + + + プロキシとの認証に使用するユーザー名の string を設定します。 + Available as of cURL 7.19.1. + + + + + + CURLOPT_PROXYUSERPWD + (int) + + + + プロキシへの接続に使用する + [username]:[password] 形式のユーザー名とパスワードの + string。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_PROXY_CAINFO + (int) + + + + プロキシ認証局 (CA) バンドルへのパス。HTTPS プロキシの検証に使用する + 1 つ以上の証明書を保持するファイルを指定する + string としてパスを設定します。 + このオプションは HTTPS サーバーではなく、HTTPS プロキシへの接続用です。 + デフォルトは cURL の cacert バンドルが格納されていると想定される + システムパスに設定されます。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_CAINFO_BLOB + (int) + + + + HTTPS プロキシの検証に使用する 1 つ以上の証明書を保持する PEM ファイルの名前の string。 + このオプションは HTTPS サーバーではなく、HTTPS プロキシへの接続用です。 + デフォルトは cURL の cacert バンドルが格納されていると想定される + システムパスに設定されます。 + Available as of PHP 8.2.0 and cURL 7.77.0. + + + + + + CURLOPT_PROXY_CAPATH + (int) + + + + HTTPS プロキシの検証に使用する複数の CA 証明書を保持するディレクトリの string。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_CRLFILE + (int) + + + + SSL 交換中に行われる証明書検証で使用する + PEM 形式の CRL（証明書失効リスト）を連結したファイル名の + string を設定します。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_ISSUERCERT + (int) + + + + プロキシ発行者 SSL 証明書のファイル名 string。 + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_PROXY_ISSUERCERT_BLOB + (int) + + + + プロキシ発行者 SSL 証明書の string。 + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_PROXY_KEYPASSWD + (int) + + + + CURLOPT_PROXY_SSLKEY 秘密鍵を使用するために + 必要なパスワードとして使用する string を設定します。 + 証明書の読み込みにパスフレーズは不要ですが、 + 秘密鍵の読み込みには必要です。 + このオプションは HTTPS サーバーではなく、HTTPS プロキシへの接続用です。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_PINNEDPUBLICKEY + (int) + + + + HTTPS プロキシ用のピン留めされた公開鍵を設定します。 + string は PEM + または DER ファイル形式であることが期待される + ピン留めされた公開鍵のファイル名にすることができます。 + string はまた、sha256// を先頭に付けて + ; で区切られた、任意の数の base64 エンコードされた sha256 ハッシュにすることもできます。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SERVICE_NAME + (int) + + + + プロキシ認証サービス名の string。 + Available as of PHP 7.0.7, cURL 7.43.0 (for HTTP proxies) and cURL 7.49.0 (for SOCKS5 proxies). + + + + + + CURLOPT_PROXY_SSLCERT + (int) + + + + HTTPS プロキシへの接続に使用するクライアント証明書のファイル名の string。 + デフォルトの形式は Secure Transport では P12、 + その他のエンジンでは PEM で、 + CURLOPT_PROXY_SSLCERTTYPE で変更できます。 + NSS または Secure Transport では、セキュリティデータベースで名前が付けられている + 認証に使用する証明書のニックネームにすることもできます。 + カレントディレクトリのファイルを使用する場合は、 + ニックネームとの混同を避けるために + ./ をプレフィックスとして付ける必要があります。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSLCERTTYPE + (int) + + + + HTTPS プロキシに接続する際に使用するクライアント証明書の形式の string。 + サポートされる形式は、Secure Transport を除き、PEM と DER です。 + OpenSSL（バージョン 0.9.3 以降）と Secure Transport + （iOS 5 以降、または OS X 10.7 以降）は + PKCS#12 エンコードされたファイルの P12 もサポートします。 + デフォルトは PEM です。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSLCERT_BLOB + (int) + + + + SSL プロキシクライアント証明書の string。 + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_PROXY_SSLKEY + (int) + + + + HTTPS プロキシへの接続に使用する秘密鍵のファイル名の string。 + デフォルトの形式は PEM で、 + CURLOPT_PROXY_SSLKEYTYPE で変更できます。 + （iOS および Mac OS X のみ）cURL が Secure Transport に対してビルドされている場合、 + このオプションは無視されます。TLS が有効な状態でビルドされている場合に利用可能です。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSLKEYTYPE + (int) + + + + 秘密鍵の形式の string。 + サポートされる形式は次のとおりです: + + PEM + DER + ENG + . + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSLKEY_BLOB + (int) + + + + HTTPS プロキシへの接続用の秘密鍵の string。 + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_PROXY_SSLVERSION + (int) + + + + 優先する HTTPS プロキシの TLS バージョンを + CURL_SSLVERSION_* + 定数のいずれかに設定します。 + デフォルトは CURL_SSLVERSION_DEFAULT です。 + + + このオプションを設定せず、リモートの SSL プロトコルバージョンを + 自動判別しようとするデフォルトの + CURL_SSLVERSION_DEFAULT のままにしておくことを推奨します。 + + + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSL_CIPHER_LIST + (int) + + + + HTTPS プロキシへの接続に使用する暗号のコロン区切りリストの string。 + OpenSSL と共に使用する場合、カンマとスペースもセパレータとして使用でき、 + !、-、および + + を演算子として使用できます。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSL_OPTIONS + (int) + + + + プロキシ SSL の動作オプションを設定します。これは + CURLSSLOPT_* 定数のビットマスクです。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSL_VERIFYHOST + (int) + + + + HTTPS プロキシの証明書の名前フィールドをプロキシ名と照合して検証するには + 2 に設定します。 + 0 に設定すると、証明書で使用されている名前に関係なく接続が成功します。 + この機能は注意して使用してください! + cURL 7.28.0 以前ではデバッグオプションとして 1 に設定します。 + cURL 7.28.1 から 7.65.3 では 1 に設定すると CURLE_BAD_FUNCTION_ARGUMENT が返されます。 + cURL 7.66.0 以降、1 と 2 は同じ値として扱われます。 + デフォルトは 2 です。 + 本番環境では、このオプションの値は 2 のままにしておくべきです。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSL_VERIFYPEER + (int) + + + + cURL がピアの証明書を検証するのを停止するには &false; に設定します。 + 検証に使用する代替証明書は CURLOPT_CAINFO オプションで + 指定でき、証明書ディレクトリは + CURLOPT_CAPATH オプションで指定できます。 + &false; に設定すると、ピア証明書の検証は常に成功します。 + デフォルトは &true; です。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_TLS13_CIPHERS + (int) + + + + プロキシへの TLS 1.3 接続に使用する暗号のコロン区切りリストの string。 + このオプションは現在、cURL が OpenSSL 1.1.1 以降を使用してビルドされている場合にのみ使用されます。 + 別の SSL バックエンドを使用している場合、TLS 1.3 の暗号スイートは + CURLOPT_PROXY_SSL_CIPHER_LIST オプションで設定できます。 + Available as of PHP 7.3.0 and cURL 7.61.0. + + + + + + CURLOPT_PROXY_TLSAUTH_PASSWORD + (int) + + + + CURLOPT_PROXY_TLSAUTH_TYPE オプションで指定された + TLS 認証方式に使用するパスワードの string。 + CURLOPT_PROXY_TLSAUTH_USERNAME オプションも設定する必要があります。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_TLSAUTH_TYPE + (int) + + + + HTTPS 接続に使用する TLS 認証方式。 + サポートされる方式は SRP です。 + + + TLS の Secure Remote Password (SRP) 認証は、 + 双方が共有秘密を持っている場合に相互認証を提供します。TLS-SRP を使用するには、 + CURLOPT_PROXY_TLSAUTH_USERNAME および + CURLOPT_PROXY_TLSAUTH_PASSWORD オプションも設定する必要があります。 + + + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_TLSAUTH_USERNAME + (int) + + + + CURLOPT_PROXY_TLSAUTH_TYPE オプションで指定された + HTTPS プロキシ TLS 認証方式に使用するユーザー名。 + CURLOPT_PROXY_TLSAUTH_PASSWORD オプションも設定する必要があります。 + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_TRANSFER_MODE + (int) + + + + HTTP プロキシ経由で行われる FTP 転送の転送モード（バイナリまたは ASCII）を設定するには + 1 に設定します。 type=a または type=i を URL に追加します。 + この設定がないか、0 に設定されている場合、 + プロキシ経由の FTP では CURLOPT_TRANSFERTEXT は効果がありません。 + デフォルトは 0 です。 + Available as of cURL 7.18.0. + + + + + + CURLOPT_PUT + (int) + + + + &true; を指定すると、ファイルを HTTP PUT します。PUT するファイルは + CURLOPT_READDATA および + CURLOPT_INFILESIZE で設定する必要があります。 + Available as of cURL 7.1.0 and deprecated as of cURL 7.12.1. + + + + + + CURLOPT_QUICK_EXIT + (int) + + + + &true; に設定すると、タイムアウトから復帰する際に + cURL がリソースのクリーンアップをスキップします。 + これにより、関連リソースがリークする可能性はありますが、 + cURL プロセスを迅速に終了させることができます。 + Available as of PHP 8.3.0 and cURL 7.87.0. + + + + + + CURLOPT_QUOTE + (int) + + + + FTP リクエストの前にサーバー上で実行する FTP コマンド string の array。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_RANDOM_FILE + (int) + + + + SSL の乱数ジェネレータのシードに使用するファイル名の string。 + Available as of cURL 7.7.0 and deprecated as of cURL 7.84.0. + + + + + + CURLOPT_RANGE + (int) + + + + 取得するデータの範囲を X-Y 形式で指定する string。X または Y は省略可能です。HTTP 転送では、 + X-Y,N-M のようにカンマ区切りで複数の範囲も指定できます。 + &null; に設定すると、バイト範囲のリクエストを無効にします。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_READDATA + (int) + + + + CURLOPT_READFUNCTION で設定されたファイル読み取り関数が + 使用するファイルポインタ resource を設定します。 + Available as of cURL 7.9.7. + + + + + + CURLOPT_READFUNCTION + (int) + + + + 以下のシグネチャを持つ callable: + + stringcallback + resourcecurlHandle + resourcestreamResource + intmaxAmountOfDataToRead + + + + curlHandle + + + cURL ハンドル。 + + + + + streamResource + + + オプション CURLOPT_READDATA を通じて + cURL に渡されたストリーム resource。 + + + + + maxAmountOfDataToRead + + + 読み取るデータの最大量。 + + + + + コールバックは、要求されたデータ量以下の長さの string を返す必要があります。 + 通常、渡されたストリーム resource から読み取ることで取得します。 + EOF を示すには空の string を返す必要があります。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_REDIR_PROTOCOLS + (int) + + + + CURLOPT_FOLLOWLOCATION が有効な場合に、 + リダイレクト先で cURL が使用できるプロトコルを制限する + CURLPROTO_* 値のビットマスク。 + これにより、リダイレクト時に特定の転送で使用できるプロトコルのサブセットを + 制限することができます。 + cURL 7.19.4 以降、デフォルトでは FILE および SCP + を除くすべてのプロトコルが許可されます。 + cURL 7.19.4 より前では、cURL はサポートされているすべてのプロトコルへ無条件にリダイレクトしていました。 + プロトコル定数の値については CURLOPT_PROTOCOLS も参照してください。 + Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0. + + + + + + CURLOPT_REDIR_PROTOCOLS_STR + (int) + + + + CURLOPT_FOLLOWLOCATION が有効な場合に、 + リダイレクト先で許可するプロトコル名（URL スキーム）を + 大文字小文字を区別しないカンマ区切りのリストの string で設定します。 + すべてのプロトコルを有効にするには ALL に設定します。 + cURL 7.65.2 以降、デフォルトは FTP、 + FTPS、HTTP および HTTPS です。 + cURL 7.40.0 から 7.65.1 では、デフォルトは + FILE、SCP、SMB および + SMBS を除くすべてのプロトコルです。 + cURL 7.40.0 より前では、デフォルトは + FILE および SCP を除くすべてのプロトコルです。 + 利用可能なプロトコルは以下のとおりです: + + DICT + FILE + FTP + FTPS + GOPHER + GOPHERS + HTTP + HTTPS + IMAP + IMAPS + LDAP + LDAPS + MQTT + POP3 + POP3S + RTMP + RTMPE + RTMPS + RTMPT + RTMPTE + RTMPTS + RTSP + SCP + SFTP + SMB + SMBS + SMTP + SMTPS + TELNET + TFTP + WS + WSS + . + Available as of PHP 8.3.0 and cURL 7.85.0. + + + + + + CURLOPT_REFERER + (int) + + + + HTTP リクエストで使用する Referer: + ヘッダの内容を含む string。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_REQUEST_TARGET + (int) + + + + URL から抽出されたパスの代わりに、次のリクエストで使用する string。 + Available as of PHP 7.3.0 and cURL 7.55.0. + + + + + + CURLOPT_RESOLVE + (int) + + + + 特定のホストとポートの組み合わせに対するカスタムアドレスを、 + 以下の形式でコロン区切りの string の array で指定します: + + array( + "example.com:80:127.0.0.1", + "example2.com:443:127.0.0.2", + ) + + Available as of cURL 7.21.3. + + + + + + CURLOPT_RESUME_FROM + (int) + + + + 転送を再開するオフセット（バイト単位）。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_RETURNTRANSFER + (int) + + + + &true; を指定すると、curl_exec の戻り値として + 転送内容を直接出力する代わりに string で返します。 + + + + + + CURLOPT_RTSP_CLIENT_CSEQ + (int) + + + + 次の RTSP リクエストで発行する CSEQ 番号を int で設定します。 + アプリケーションが以前に切断された接続を再開する場合に便利です。 + CSEQ はこの新しい番号から順に増加します。 + デフォルトは 0 です。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_REQUEST + (int) + + + + 実行する RTSP リクエストの種類を設定します。 + CURL_RTSPREQ_* + 定数のいずれかである必要があります。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_SERVER_CSEQ + (int) + + + + 次の RTSP サーバーからクライアントへのリクエストで期待する + CSEQ 番号を int で設定します。 + この機能（サーバーリクエストのリスニング）は未実装です。 + デフォルトは 0 です。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_SESSION_ID + (int) + + + + ハンドルの現在の RTSP セッション ID の値を string で設定します。 + この値が非 &null; の値に設定されると、 + サーバーから受信した ID が一致しない場合、 + cURL は CURLE_RTSP_SESSION_ERROR を返します。 + &null; に設定すると、サーバーがレスポンスで初めて ID を設定した際に、 + cURL が自動的に ID を設定します。 + デフォルトは &null; です。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_STREAM_URI + (int) + + + + 操作対象のストリーム URI を string で設定します。 + 設定されていない場合、cURL は RTSP ストリーム URI の代わりに + * を渡してジェネリックなサーバーオプションで + 操作するデフォルトの動作になります。 + RTSP を扱う際、CURLOPT_RTSP_STREAM_URI + はリクエストヘッダでサーバーに送信する URL を示し、 + CURLOPT_URL は接続先を示します。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_TRANSPORT + (int) + + + + この RTSP セッションの Transport: ヘッダを設定します。 + Available as of cURL 7.20.0. + + + + + + CURLOPT_SAFE_UPLOAD + (int) + + + + 常に &true; であり、CURLOPT_POSTFIELDS での + ファイルアップロード用の @ プレフィックスのサポートを無効にします。 + これにより、@ で始まる値をフィールドとして安全に + 渡すことができます。代わりに CURLFile を + アップロードに使用できます。 + + + + + + CURLOPT_SASL_AUTHZID + (int) + + + + 転送用の認可アイデンティティ（authzid）の string。PLAIN SASL + 認証メカニズムにのみ適用され、オプションです。指定されない場合、 + ユーザー名で指定された認証アイデンティティ（authcid）のみが + パスワードとともにサーバーに送信されます。 + サーバーは、提供されない場合 authcid から authzid を導出し、内部的に使用します。 + Available as of PHP 8.2.0 and cURL 7.66.0. + + + + + + CURLOPT_SASL_IR + (int) + + + + &true; を指定すると、最初のパケットで初期レスポンスの送信を有効にします。 + Available as of PHP 7.0.7 and cURL 7.31.0. + + + + + + CURLOPT_SERVICE_NAME + (int) + + + + 認証サービス名を含む string。 + Available as of PHP 7.0.7 and cURL 7.43.0. + + + + + + CURLOPT_SHARE + (int) + + + + curl_share_init の結果。cURL ハンドルが + 共有ハンドルのデータを使用するようにします。 + Available as of cURL 7.10. + + + + + + CURLOPT_SOCKS5_AUTH + (int) + + + + 使用する SOCKS5 認証メソッド。オプションは以下のとおりです: + + CURLAUTH_BASIC + CURLAUTH_GSSAPI + CURLAUTH_NONE + . + 複数のメソッドが設定されている場合、cURL はサーバーがサポートするメソッドを + 確認し、最適なものを選択します。 + デフォルトは CURLAUTH_BASIC|CURLAUTH_GSSAPI です。 + 実際のユーザー名とパスワードは CURLOPT_PROXYUSERPWD オプションで設定します。 + Available as of PHP 7.3.0 and cURL 7.55.0. + + + + + + CURLOPT_SOCKS5_GSSAPI_NEC + (int) + + + + 1 で有効に、0 で無効にします。 + GSSAPI ネゴシエーションの一環としての保護モードネゴシエーションの + 非保護交換を制御します。 + Available as of cURL 7.19.4. + + + + + + CURLOPT_SOCKS5_GSSAPI_SERVICE + (int) + + + + SOCKS5 サービスの名前を保持する string を設定します。 + デフォルトは rcmd です。 + Available as of cURL 7.19.4 and deprecated as of cURL 7.49.0. + 代わりに CURLOPT_PROXY_SERVICE_NAME を使用してください。 + + + + + + CURLOPT_SSH_AUTH_TYPES + (int) + + + + 以下の定数の 1 つ以上で構成されるビットマスク: + + CURLSSH_AUTH_PUBLICKEY + CURLSSH_AUTH_PASSWORD + CURLSSH_AUTH_HOST + CURLSSH_AUTH_KEYBOARD + CURLSSH_AUTH_AGENT + CURLSSH_AUTH_ANY + . + デフォルトは CURLSSH_AUTH_ANY です。 + Available as of cURL 7.16.1. + + + + + + CURLOPT_SSH_COMPRESSION + (int) + + + + &true; で有効に、&false; で組み込みの SSH 圧縮を無効にします。 + サーバーがこのリクエストを無視する可能性があることに注意してください。 + デフォルトは &false; です。 + Available as of PHP 7.3.0 and cURL 7.56.0. + + + + + + CURLOPT_SSH_HOSTKEYFUNCTION + (int) + + + + SSH ホストキーの検証が必要な場合に呼び出される callable。 + コールバックは以下のシグネチャを持つ必要があります: + + intcallback + resourcecurlHandle + intkeyType + stringkey + intkeyLength + + + + curlHandle + + + cURL ハンドル。 + + + + + keyType + + + CURLKHTYPE_* キータイプのいずれか。 + + + + + key + + + 検証するキー。 + + + + + keyLength + + + キーの長さ（バイト単位）。 + + + + + このコールバックは CURLOPT_SSH_KNOWNHOSTS をオーバーライドします。 + Available as of PHP 8.3.0 and cURL 7.84.0. + + + + + + CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 + (int) + + + + リモートホストの公開鍵の MD5 チェックサムを含む + 32 桁の 16 進数の string。md5sum が一致しない限り、 + cURL はホストへの接続を拒否します。 + このオプションは SCP および SFTP 転送にのみ適用されます。 + Available as of cURL 7.17.1. + + + + + + CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 + (int) + + + + リモートホストの公開鍵の base64 エンコードされた SHA256 ハッシュを含む string。 + 指定されたハッシュがリモートホストの提供するハッシュと一致しない場合、転送は失敗します。 + Available as of PHP 8.2.0 and cURL 7.80.0. + + + + + + CURLOPT_SSH_KNOWNHOSTS + (int) + + + + libssh2 がサポートする OpenSSH ファイル形式を使用する + known_host ファイルのファイル名を設定します。 + Available as of cURL 7.19.6. + + + + + + CURLOPT_SSH_PRIVATE_KEYFILE + (int) + + + + 秘密鍵のファイル名。使用されない場合、HOME 環境変数が設定されていれば + cURL はデフォルトで $HOME/.ssh/id_dsa を使用し、 + HOME が設定されていない場合はカレントディレクトリの id_dsa を使用します。 + ファイルがパスワードで保護されている場合は、 + CURLOPT_KEYPASSWD でパスワードを設定してください。 + Available as of cURL 7.16.1. + + + + + + CURLOPT_SSH_PUBLIC_KEYFILE + (int) + + + + 公開鍵のファイル名。使用されない場合、HOME 環境変数が設定されていれば + cURL はデフォルトで $HOME/.ssh/id_dsa.pub を使用し、 + HOME が設定されていない場合はカレントディレクトリの id_dsa.pub を使用します。 + Available as of cURL 7.16.1. + + + + + + CURLOPT_SSLCERT + (int) + + + + PEM 形式の証明書を含むファイルの名前。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_SSLCERTPASSWD + (int) + + + + CURLOPT_SSLCERT 証明書を使用するために + 必要なパスワード。 + Available as of cURL 7.1.0 and deprecated as of cURL 7.17.0. + + + + + + CURLOPT_SSLCERTTYPE + (int) + + + + 証明書の形式を表す string。サポートされる形式は以下のとおりです: + + PEM + DER + ENG + P12 + . + P12（PKCS#12 エンコードファイル用）は OpenSSL 0.9.3 以降で利用可能です。 + デフォルトは PEM です。 + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLCERT_BLOB + (int) + + + + SSL クライアント証明書を含む string。 + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_SSLENGINE + (int) + + + + CURLOPT_SSLKEY で指定された + プライベート SSL キーの暗号エンジンの string 識別子。 + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLENGINE_DEFAULT + (int) + + + + 非対称暗号操作に使用される暗号エンジンの string 識別子。 + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLKEY + (int) + + + + プライベート SSL キーを含むファイルの名前。 + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLKEYPASSWD + (int) + + + + CURLOPT_SSLKEY で指定されたプライベート SSL キーを + 使用するために必要な秘密パスワード。 + + + このオプションには機密性の高いパスワードが含まれるため、 + このオプションを含む PHP スクリプトを安全に保管してください。 + + + Available as of cURL 7.9.3 and deprecated as of cURL 7.17.0. + + + + + + CURLOPT_SSLKEYTYPE + (int) + + + + CURLOPT_SSLKEY で指定されたプライベート SSL キーの + キータイプ。サポートされるキータイプは以下のとおりです: + + PEM + DER + ENG + . + デフォルトは PEM です。 + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLKEY_BLOB + (int) + + + + クライアント証明書用のプライベートキーを含む string。 + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_SSLVERSION + (int) + + + + CURL_SSLVERSION_* 定数のいずれか。 + + + このオプションは設定せず、デフォルトのままにしておくことを推奨します。 + SSLv2 および SSLv3 の既知の脆弱性を考慮すると、 + CURL_SSLVERSION_SSLv2 + または + CURL_SSLVERSION_SSLv3 + に設定することは非常に危険です。 + + + デフォルトは CURL_SSLVERSION_DEFAULT です。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_SSL_CIPHER_LIST + (int) + + + + TLS 1.2（1.1、1.0）接続に使用する暗号をコロン区切りで指定する string。 + Available as of cURL 7.9. + + + + + + CURLOPT_SSL_EC_CURVES + (int) + + + + 楕円曲線アルゴリズムのコロン区切りリスト。例えば、 + X25519:P-521 は 2 つの楕円曲線の有効なリストです。 + このオプションは、cURL がビルドされた SSL バックエンドがサポートしている場合に、 + SSL ハンドシェイクにおけるクライアントの鍵交換アルゴリズムを定義します。 + Available as of PHP 8.2.0 and cURL 7.73.0. + + + + + + CURLOPT_SSL_ENABLE_ALPN + (int) + + + + &false; を指定すると、SSL ハンドシェイクでの ALPN を無効にします + （cURL がビルドされた SSL バックエンドがサポートしている場合）。 + http2 のネゴシエーションに使用できます。 + Available as of PHP 7.0.7 and cURL 7.36.0. + + + + + + CURLOPT_SSL_ENABLE_NPN + (int) + + + + &false; を指定すると、SSL ハンドシェイクでの NPN を無効にします + （cURL がビルドされた SSL バックエンドがサポートしている場合）。 + http2 のネゴシエーションに使用できます。 + Available as of PHP 7.0.7 and cURL 7.36.0, and deprecated as of cURL 7.86.0. + + + + + + CURLOPT_SSL_FALSESTART + (int) + + + + &true; で有効に、&false; で TLS false start を無効にします。 + TLS false start は、TLS クライアントがサーバーの Finished + メッセージを検証する前にアプリケーションデータの送信を開始するモードです。 + Available as of PHP 7.0.7 and cURL 7.42.0. + + + + + + CURLOPT_SSL_OPTIONS + (int) + + + + SSL の動作オプションを設定します。 + CURLSSLOPT_* 定数のビットマスクです。 + デフォルトではどのビットも設定されていません。 + Available as of PHP 7.0.7. and cURL 7.25.0. + + + + + + CURLOPT_SSL_SESSIONID_CACHE + (int) + + + + 0 で無効に、1 で有効にします。 + SSL セッション ID のキャッシュを制御します。 + デフォルトでは、すべての転送でキャッシュが有効な状態で行われます。 + Available as of cURL 7.16.0. + + + + + + CURLOPT_SSL_VERIFYHOST + (int) + + + + 2 を指定すると、SSL ピア証明書の Common Name フィールドまたは + Subject Alternate Name フィールドが、指定されたホスト名と一致するかを検証します。 + 0 を指定すると、名前のチェックを行いません。 + 1 は使用すべきではありません。 + 本番環境では、このオプションの値は 2（デフォルト値）のままにしておく必要があります。 + 値 1 のサポートは cURL 7.28.1 で削除されました。 + Available as of cURL 7.8.1. + + + + + CURLOPT_SSL_VERIFYPEER + (int) + + + + &false; を指定すると、cURL がピアの証明書を検証しなくなります。 + 検証に使用する代替証明書は CURLOPT_CAINFO オプションで指定でき、 + 証明書ディレクトリは CURLOPT_CAPATH オプションで指定できます。 + cURL 7.10 以降、デフォルトは &true; です。 + cURL 7.10 以降、デフォルトの CA 証明書バンドルがインストールされます。 + Available as of cURL 7.4.2. + + + + + + CURLOPT_SSL_VERIFYSTATUS + (int) + + + + &true; で証明書のステータス検証を有効にし、&false; で無効にします。 + Available as of PHP 7.0.7 and cURL 7.41.0. + + + + + + CURLOPT_STDERR + (int) + + + + STDERR の代わりにエラーを出力する別の場所を指す + ファイルハンドル resource を指定します。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_STREAM_WEIGHT + (int) + + + + ストリームの重みを数値（1 から 256 の間の数値）で設定します。 + Available as of PHP 7.0.7 and cURL 7.46.0. + + + + + + CURLOPT_SUPPRESS_CONNECT_HEADERS + (int) + + + + &true; を指定すると、CURLOPT_HTTPPROXYTUNNEL が使用され + CONNECT リクエストが行われる際に、ユーザーコールバック関数 + CURLOPT_HEADERFUNCTION および CURLOPT_WRITEFUNCTION + からプロキシの CONNECT レスポンスヘッダーを抑制します。 + デフォルトは &false; です。 + Available as of PHP 7.3.0 and cURL 7.54.0. + + + + + + CURLOPT_TCP_FASTOPEN + (int) + + + + &true; で TCP Fast Open を有効にし、&false; で無効にします。 + Available as of PHP 7.0.7 and cURL 7.49.0. + + + + + + CURLOPT_TCP_KEEPALIVE + (int) + + + + 1 に設定すると、TCP キープアライブプローブが送信されます。 + これらのプローブの遅延と頻度は、オペレーティングシステムがサポートしている場合、 + CURLOPT_TCP_KEEPIDLE および + CURLOPT_TCP_KEEPINTVL オプションで制御できます。 + 0（デフォルト）に設定すると、キープアライブプローブは無効になります。 + プローブの最大数は CURLOPT_TCP_KEEPCNT オプションで設定できます。 + Available as of cURL 7.25.0. + + + + + + CURLOPT_TCP_KEEPIDLE + (int) + + + + CURLOPT_TCP_KEEPALIVE が有効な場合に、 + 接続がアイドル状態のままキープアライブプローブを送信するまでの + オペレーティングシステムの待機時間を秒単位で設定します。 + すべてのオペレーティングシステムがこのオプションをサポートしているわけではありません。 + デフォルトは 60 です。 + Available as of cURL 7.25.0. + + + + + + CURLOPT_TCP_KEEPINTVL + (int) + + + + CURLOPT_TCP_KEEPALIVE が有効な場合に、 + キープアライブプローブの送信間隔を秒単位で設定します。 + すべてのオペレーティングシステムがこのオプションをサポートしているわけではありません。 + デフォルトは 60 です。 + Available as of cURL 7.25.0. + + + + + + CURLOPT_TCP_KEEPCNT + (int) + + + + TCP キープアライブプローブの最大数を設定します。 + デフォルトは 9 です。 + Available as of PHP 8.4.0 and cURL 8.9.0. + + + + + + CURLOPT_TCP_NODELAY + (int) + + + + &true; を指定すると、ネットワーク上の小さなパケットの数を最小限にしようとする + TCP の Nagle アルゴリズムを無効にします。 + デフォルトは &true; です。 + Available as of cURL 7.11.2. + + + + + + CURLOPT_TELNETOPTIONS + (int) + + + + telnet ネゴシエーションに渡す string の array を設定します。 + 変数は <option=value> の形式で指定する必要があります。 + cURL は TTYPE、XDISPLOC、 + および NEW_ENV オプションをサポートしています。 + Available as of cURL 7.7.0. + + + + + + CURLOPT_TFTP_BLKSIZE + (int) + + + + TFTP データ転送に使用するブロックサイズを設定します。 + 有効な範囲は 8-65464 バイトです。 + このオプションが指定されない場合、デフォルトの 512 バイトが使用されます。 + 指定されたブロックサイズは、リモートサーバーがサポートしている場合にのみ使用されます。 + サーバーがオプション確認応答を返さないか、 + ブロックサイズなしのオプション確認応答を返した場合、 + デフォルトの 512 バイトが使用されます。 + Available as of cURL 7.19.4. + + + + + + CURLOPT_TFTP_NO_OPTIONS + (int) + + + + &true; を指定すると、TFTP オプションリクエストを送信しません。 + デフォルトは &false; です。 + Available as of PHP 7.0.7 and cURL 7.48.0. + + + + + + CURLOPT_TIMECONDITION + (int) + + + + CURLOPT_TIMEVALUE の扱い方を設定します。 + CURL_TIMECOND_IFMODSINCE を使用すると、 + CURLOPT_TIMEVALUE で指定された時刻以降に + 変更されている場合にのみページを返します。変更されていない場合、 + CURLOPT_HEADER が &true; であれば + 304 Not Modified ヘッダーが返されます。 + 逆の効果を得るには CURL_TIMECOND_IFUNMODSINCE を使用します。 + CURLOPT_TIMEVALUE を無視して常にページを返すには + CURL_TIMECOND_NONE を使用します。 + CURL_TIMECOND_NONE がデフォルトです。 + cURL 7.46.0 より前のデフォルトは + CURL_TIMECOND_IFMODSINCE でした。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_TIMEOUT + (int) + + + + cURL 関数の実行を許可する最大秒数。 + デフォルトは 0 で、転送中にタイムアウトしないことを意味します。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_TIMEOUT_MS + (int) + + + + cURL 関数の実行を許可する最大ミリ秒数。 + cURL が標準のシステム名前解決を使用するようにビルドされている場合、 + 接続のその部分では依然としてタイムアウトに1秒単位の解像度が使用され、 + 許可される最小タイムアウトは1秒です。 + デフォルトは 0 で、転送中にタイムアウトしないことを意味します。 + Available as of cURL 7.16.2. + + + + + + CURLOPT_TIMEVALUE + (int) + + + + 1970年1月1日からの秒数。この時刻は + CURLOPT_TIMECONDITION で使用されます。 + デフォルトは 0 です。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_TIMEVALUE_LARGE + (int) + + + + 1970年1月1日からの秒数。この時刻は + CURLOPT_TIMECONDITION で使用されます。デフォルトはゼロです。 + このオプションと CURLOPT_TIMEVALUE の違いは引数の型です。 + 'long' が32ビット幅しかないシステムでは、 + 2038年以降の日付を設定するためにこのオプションを使用する必要があります。 + Available as of PHP 7.3.0 and cURL 7.59.0. + + + + + + CURLOPT_TLS13_CIPHERS + (int) + + + + TLS 1.3 接続に使用する暗号のコロン区切りリストの string。 + このオプションは現在、cURL が OpenSSL 1.1.1 以降を使用してビルドされている場合にのみ使用されます。 + 異なる SSL バックエンドを使用する場合、TLS 1.3 暗号スイートは + CURLOPT_SSL_CIPHER_LIST オプションで設定できます。 + Available as of PHP 7.3.0 and cURL 7.61.0. + + + + + + CURLOPT_TLSAUTH_PASSWORD + (int) + + + + CURLOPT_TLSAUTH_TYPE オプションで指定された + TLS 認証方式に使用するパスワードを設定します。 + CURLOPT_TLSAUTH_USERNAME オプションも設定する必要があります。 + この機能は TLS SRP に依存しており、TLS 1.3 では動作しません。 + Available as of cURL 7.21.4. + + + + + + CURLOPT_TLSAUTH_TYPE + (int) + + + + TLS 認証方式を string で設定します。 + サポートされている方式は SRP + （TLS セキュアリモートパスワード認証）です。 + Available as of cURL 7.21.4. + + + + + + CURLOPT_TLSAUTH_USERNAME + (int) + + + + CURLOPT_TLSAUTH_TYPE オプションで指定された + TLS 認証方式に使用するユーザー名を string で設定します。 + CURLOPT_TLSAUTH_PASSWORD オプションも設定する必要があります。 + この機能は TLS SRP に依存しており、TLS 1.3 では動作しません。 + Available as of cURL 7.21.4. + + + + + + CURLOPT_TRANSFER_ENCODING + (int) + + + + 1 に設定すると、送信 HTTP リクエストで圧縮された + Transfer Encoding のリクエストを有効にし、 + 0 で無効にします。 + サーバーが圧縮された Transfer Encoding で応答した場合、 + cURL は受信時に自動的に解凍します。 + デフォルトは 0 です。 + Available as of cURL 7.21.6. + + + + + + CURLOPT_TRANSFERTEXT + (int) + + + + &true; を指定すると、FTP 転送に ASCII モードを使用します。 + LDAP の場合、HTML の代わりにプレーンテキストでデータを取得します。 + Windows システムでは、STDOUT をバイナリモードに設定しません。 + デフォルトは &false; です。 + Available as of cURL 7.1.1. + + + + + + CURLOPT_UNIX_SOCKET_PATH + (int) + + + + Unix ドメインソケットを接続エンドポイントとして使用できるようにし、 + 指定された string にパスを設定します。 + 無効にするには &null; を設定します。 + デフォルトは &null; です。 + Available as of PHP 7.0.7 and cURL 7.40.0. + + + + + + CURLOPT_UNRESTRICTED_AUTH + (int) + + + + &true; を指定すると、ホスト名が変わった場合でも、 + （CURLOPT_FOLLOWLOCATION を使用して） + リダイレクト先にユーザー名とパスワードを送信し続けます。 + デフォルトは &false; です。 + Available as of cURL 7.10.4. + + + + + + CURLOPT_UPKEEP_INTERVAL_MS + (int) + + + + 一部のプロトコルには「接続維持」メカニズムがあります。これらのメカニズムは通常、 + 接続を維持するために既存の接続上でトラフィックを送信します。 + このオプションは接続維持間隔を定義します。 + 現在、接続維持メカニズムを持つプロトコルは HTTP/2 のみです。 + 接続維持間隔を超過すると、接続上で HTTP/2 PING フレームが送信されます。 + デフォルトは CURL_UPKEEP_INTERVAL_DEFAULT で、 + 現在は 60 秒です。 + Available as of PHP 8.2.0 and cURL 7.62.0. + + + + + + CURLOPT_UPLOAD + (int) + + + + &true; を指定すると、アップロードの準備と実行を行います。 + デフォルトは &false; です。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_UPLOAD_BUFFERSIZE + (int) + + + + cURL アップロードバッファの優先バッファサイズ（バイト単位）。 + アップロードバッファサイズのデフォルトは 64 キロバイトです。設定可能な最大バッファサイズは 2 メガバイトです。 + 設定可能な最小バッファサイズは 16 キロバイトです。 + Available as of PHP 8.2.0 and cURL 7.62.0. + + + + + + CURLOPT_URL + (int) + + + + 取得する URL。curl_init でセッションを初期化する際にも設定できます。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_USE_SSL + (int) + + + + FTP、SMTP、POP3、IMAP などを使用する際の転送に必要な SSL/TLS のレベルを設定します。 + これらはすべてプレーンテキストで開始され、STARTTLS コマンドを使用して + SSL に「アップグレード」されるプロトコルです。 + CURLUSESSL_* 定数のいずれかに設定します。 + Available as of cURL 7.17.0. + + + + + + CURLOPT_USERAGENT + (int) + + + + HTTP リクエストで使用される User-Agent: ヘッダーの内容。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_USERNAME + (int) + + + + 認証に使用するユーザー名。 + Available as of cURL 7.19.1. + + + + + + CURLOPT_USERPWD + (int) + + + + 接続に使用する [username]:[password] 形式の + ユーザー名とパスワード。 + Available as cURL 7.1.0. + + + + + + CURLOPT_VERBOSE + (int) + + + + &true; を指定すると、詳細な情報を出力します。 + 出力は STDERR、または + CURLOPT_STDERR で指定されたファイルに書き込まれます。 + デフォルトは &false; です。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_WILDCARDMATCH + (int) + + + + 1 に設定すると、ファイル名パターンに従って複数のファイルを転送します。 + パターンは CURLOPT_URL オプションの一部として、 + URL の最後の部分（ファイル名）に fnmatch ライクなパターン（シェルパターンマッチング）を + 使用して指定できます。 + Available as of cURL 7.21.0. + + + + + + CURLOPT_WRITEFUNCTION + (int) + + + + 以下のシグネチャを持つ callable: + + intcallback + resourcecurlHandle + stringdata + + + + curlHandle + + + cURL ハンドル。 + + + + + data + + + 書き込まれるデータ。 + + + + + データはコールバックによって保存される必要があり、 + コールバックは書き込まれた正確なバイト数を返す必要があります。 + そうでない場合、転送はエラーで中断されます。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_WRITEHEADER + (int) + + + + 転送のヘッダー部分が書き込まれるファイルへのファイルハンドル resource を指定します。 + Available as of cURL 7.1.0. + + + + + + CURLOPT_WS_OPTIONS + (int) + + + + WebSocket の動作オプションを設定するビットマスクを指定します。 + 利用可能な唯一のオプションは CURLWS_RAW_MODE です。 + デフォルトは 0 です。 + Available as of PHP 8.3.0 and cURL 7.86.0. + + + + + + CURLOPT_XFERINFOFUNCTION + (int) + + + + 以下のシグネチャを持つ callable: + + intcallback + resourcecurlHandle + intbytesToDownload + intbytesDownloaded + intbytesToUpload + intbytesUploaded + + + + curlHandle + + + cURL ハンドル。 + + + + + bytesToDownload + + + この転送でダウンロードが予想される合計バイト数。 + + + + + bytesDownloaded + + + これまでにダウンロードされたバイト数。 + + + + + bytesToUpload + + + この転送でアップロードが予想される合計バイト数。 + + + + + bytesUploaded + + + これまでにアップロードされたバイト数。 + + + + + 転送を中断し CURLE_ABORTED_BY_CALLBACK エラーを設定するには + 1 を返します。 + Available as of PHP 8.2.0 and cURL 7.32.0. + + + + + + CURLOPT_SERVER_RESPONSE_TIMEOUT + (int) + + + + FTP、SFTP、IMAP、 + SCP、SMTP、または POP3 サーバーからの + 応答を cURL が待機するタイムアウト（秒単位）。 + このオプションは、cURL 7.85.0 で非推奨となった既存の + CURLOPT_FTP_RESPONSE_TIMEOUT オプションを置き換えるものです。 + Available as of PHP 8.4.0. + + + + + + CURLOPT_XOAUTH2_BEARER + (int) + + + + OAuth 2.0 アクセストークンを指定します。 + 無効にするには &null; を設定します。 + デフォルトは &null; です。 + Available as of PHP 7.0.7 and cURL 7.33.0. + + + + + + CURLOPT_PREREQFUNCTION + (int) + + + + 接続が確立された後、リクエストペイロード（例えば HTTP 接続の + GET/POST/DELETE リクエスト）が送信される前に呼び出される、 + 以下のシグネチャを持つ callable。 + 送信元と送信先の IP アドレスおよびポート番号に応じて、 + 接続を中断または許可するために使用できます: + + intcallback + CurlHandlecurlHandle + stringdestination_ip + stringlocal_ip + intdestination_port + intlocal_port + + + + curlHandle + + + cURL ハンドル。 + + + + + destination_ip + + + この接続で確立されたリモートサーバーのプライマリ IP。 + FTP の場合、これはコントロール接続の IP です。 + IPv6 アドレスは角括弧なしで表されます。 + + + + + local_ip + + + この接続の送信元 IP。 + IPv6 アドレスは角括弧なしで表されます。 + + + + + destination_port + + + この接続で確立されたリモートサーバーのプライマリポート番号。 + FTP の場合、これはコントロール接続のポートです。 + プロトコルに応じて TCP または UDP のポート番号になります。 + + + + + local_port + + + この接続の送信元ポート番号。 + プロトコルに応じて TCP または UDP のポート番号になります。 + + + + + リクエストを許可するには CURL_PREREQFUNC_OK を、 + 転送を中断するには CURL_PREREQFUNC_ABORT を返します。 + Available as of PHP 8.4.0 and cURL 7.80.0. + + + + + + CURLOPT_DEBUGFUNCTION + (int) + + + + Available as of PHP 8.4.0. + このオプションには CURLOPT_VERBOSE オプションが有効になっている必要があります。 + 標準の cURL 詳細出力を置き換える callable。 + このコールバックは、リクエストのさまざまな段階で詳細なデバッグ情報とともに呼び出されます。 + コールバックは以下のシグネチャに一致する必要があります: + + voidcallback + CurlHandlecurlHandle + inttype + stringdata + + + + curlHandle + + + cURL ハンドル。 + + + + + type + + + data 値の種類を示す以下の定数のいずれか: + + + + + CURLINFO_TEXT + (int) + + + + 情報テキスト。 + + + + + + CURLINFO_HEADER_IN + (int) + + + + ピアから受信したヘッダー（またはヘッダーのような）データ。 + + + + + + CURLINFO_HEADER_OUT + (int) + + + + ピアに送信されたヘッダー（またはヘッダーのような）データ。 + + + + + + CURLINFO_DATA_IN + (int) + + + + ピアから受信した未処理のプロトコルデータ。 + データがエンコードまたは圧縮されていても、このコールバックにはデコードも解凍もされずに提供されます。 + + + + + + CURLINFO_DATA_OUT + (int) + + + + ピアに送信されたプロトコルデータ。 + + + + + + CURLINFO_SSL_DATA_IN + (int) + + + + ピアから受信した SSL/TLS（バイナリ）データ。 + + + + + + CURLINFO_SSL_DATA_OUT + (int) + + + + ピアに送信された SSL/TLS（バイナリ）データ。 + + + + + + + + data + + + type パラメータで示される種類の詳細なデバッグデータ。 + + + + + + + + \ No newline at end of file