PHPカールオプション一覧（超詳細）_PHPチュートリアル-PHPチュートリアル-php.cn

最初のカテゴリ:
以下のオプションのオプションパラメータの値は、bool 型の値に設定する必要があります:
オプション
オプションの値
備考

CURLOPT_AUTOREFERER
場所に基づく場合: オリエンテーション中に、 Referer: ヘッダー内の情報が自動的に設定されます。
CURLOPT_BINARYTRANSFER
CURLOPT_RETURNTRANSFER が有効な場合、生の (Raw) 出力を返します。
CURLOPT_COOKIESESSION
有効にすると、curl は 1 つのセッション Cookie のみを渡し、他の Cookie を無視します。デフォルトでは、curl はすべての Cookie をサーバーに返します。セッション Cookie は、サーバー側のセッションが有効かどうかを判断するために使用される Cookie を指します。
CURLOPT_CRLF
有効な場合、Unix の改行文字を復帰文字と改行文字に変換します。
CURLOPT_DNS_USE_GLOBAL_CACHE
有効にすると、グローバル DNS キャッシュが有効になり、デフォルトで有効になります。
CURLOPT_FAILONERROR
HTTP ステータスコードを表示します。デフォルトの動作では、数値が 400 以下の HTTP メッセージを無視します。
CURLOPT_FILETIME
有効にすると、リモートドキュメント内の情報の変更が試行されます。結果情報は、curl_getinfo() 関数の CURLINFO_FILETIME オプションを通じて返されます。 curl_getinfo().
CURLOPT_FOLLOWLOCATION
有効にすると、サーバーから返される「Location:」がヘッダーに配置され、再帰的に返される回数を制限するために CURLOPT_MAXREDIRS を使用します。
CURLOPT_FORBID_REUSE
インタラクション完了後に強制的に切断され、再利用することはできません。
CURLOPT_FRESH_CONNECT
新しい接続を取得して、キャッシュ内の接続を置き換えます。
CURLOPT_FTP_USE_EPRT
有効にすると、FTP ダウンロード時に EPRT (または LPRT) コマンドを使用します。 FALSE に設定すると、PORT コマンドのみを使用して EPRT と LPRT が無効になります。
CURLOPT_FTP_USE_EPSV
有効にすると、FTP 転送中に PASV モードに戻る前に EPSV コマンドが最初に試行されます。 FALSE に設定すると、EPSV コマンドが無効になります。
CURLOPT_FTPAPPEND
有効にすると、ファイルを上書きするのではなく追加書き込みします。
CURLOPT_FTPASCII
CURLOPT_TRANSFERTEXTのエイリアス。
CURLOPT_FTPLISTONLY
有効な場合は、FTP ディレクトリの名前のみがリストされます。
CURLOPT_HEADER
有効にすると、ヘッダーファイル情報がデータストリームとして出力されます。
CURLINFO_HEADER_OUT
有効な場合の追跡ハンドルのリクエスト文字列。
PHP 5.1.3 以降で利用可能です。 CURLINFO_ プレフィックスは意図的なものです。

CURLOPT_HTTPGET
有効にすると、HTTP メソッドは GET に設定されるため、GET は変更された場合にのみ使用されます。
CURLOPT_HTTPPROXYTUNNEL
有効にすると、HTTP プロキシ経由で送信されます。
CURLOPT_MUTE
有効にすると、cURL 関数で変更されたすべてのパラメーターがデフォルト値に復元されます。
CURLOPT_NETRC
接続が確立されたら、~/.netrc ファイルにアクセスして、リモートサイトに接続するためのユーザー名とパスワード情報を取得します。
CURLOPT_NOBODY
有効にすると、HTMLのBODY部分が出力されなくなります。
CURLOPT_NOPROGRESS
有効時にcurl転送の進行状況バーを非表示にするこの項目のデフォルト設定は有効です。
注意:
PHP はこのオプションを自動的に TRUE に設定します。このオプションはデバッグ目的でのみ変更してください。

CURLOPT_NOSIGNAL
有効にすると、curl によって php に渡されるすべてのシグナルを無視します。この項目は、SAPI マルチスレッド送信中にデフォルトで有効になります。
cURL は 7.10 で追加されました。

CURLOPT_POST
有効にすると、フォーム送信と同様に、タイプ: application/x-www-form-urlencoded の通常の POST リクエストが送信されます。
CURLOPT_PUT
を有効にすると、HTTP によるファイルの送信が許可されます。CURLOPT_INFILE と CURLOPT_INFILESIZE を同時に設定する必要があります。
CURLOPT_RETURNTRANSFER
curl_exec()で取得した情報を直接出力するのではなく、ファイルストリームの形式で返します。
CURLOPT_SSL_VERIFYPEER
無効にすると、cURL はサーバーからの検証を終了します。 CURLOPT_CAINFO オプションを使用して証明書を設定します。 CURLOPT_CAPATH オプションを使用して証明書ディレクトリを設定します。 CURLOPT_SSL_VERIFYPEER (デフォルトは 2) が有効な場合は、CURLOPT_SSL_VERIFYHOST を TRUE に設定する必要があります。それ以外の場合は、FALSE に設定します。
cURL 7.10 以降のデフォルトは TRUE です。 cURL 7.10 以降、バンドルのインストールがデフォルトで行われます。

CURLOPT_TRANSFERTEXT
FTP 転送に ASCII モードを使用できるようにします。 LDAP の場合、HTML ではなくプレーンテキスト情報を取得します。 Windows システムでは、システムは STDOUT をバイナリモードに設定しません。
CURLOPT_UNRESTRICTED_AUTH
ドメイン名が変更された場合でも、CURLOPT_FOLLOWLOCATION を使用して生成されたヘッダー内の複数の場所にユーザー名とパスワードの情報を継続的に追加します。
CURLOPT_UPLOAD
を有効にすると、ファイルのアップロードが許可されます。
CURLOPT_VERBOSE
有効にすると、すべての情報がレポートされ、STDERR または指定された CURLOPT_STDERR に保存されます。

2番目のカテゴリ:
以下のオプションのオプションパラメータの値は整数型の値に設定する必要があります:
オプション
オプションの値
備考

CURLOPT_BUFFERSIZE
毎回取得キャッシュのサイズこれはデータに読み込まれますが、この値が毎回入力されるという保証はありません。
cURL 7.10 で追加されました。

CURLOPT_CLOSEPOLICY
他に CURLCLOSEPOLICY_LEAST_RECENTLY_USED または CURLCLOSEPOLICY_OLDEST のいずれかがありますが、cURL はまだサポートしていません。
CURLOPT_CONNECTTIMEOUT
接続を開始するまでの待機時間。0 に設定すると、無期限に待機します。
CURLOPT_CONNECTTIMEOUT_MS
接続試行を待機する時間 (ミリ秒単位)。 0 に設定すると、無限に待機します。
cURL 7.16.2 で追加されました。 PHP 5.2.3 以降で利用可能です。

CURLOPT_DNS_CACHE_TIMEOUT
DNS 情報をメモリに保存する時間を設定します。デフォルトは 120 秒です。
CURLOPT_FTPSSLAUTH
FTP 認証方法: CURLFTPAUTH_SSL (最初に SSL を試す)、CURLFTPAUTH_TLS (最初に TLS を試す)、または CURLFTPAUTH_DEFAULT (cURL が自動的に決定する)。
cURL 7.12.2 で追加されました。

CURLOPT_HTTP_VERSION
CURL_HTTP_VERSION_NONE (デフォルト。どのバージョンを使用するかを cURL に決定させる)、CURL_HTTP_VERSION_1_0 (HTTP/1.0 を強制的に使用する)、または CURL_HTTP_VERSION_1_1 (HTTP/1.1 を使用するように強制する)。
CURLOPT_HTTPAUTH
使用される HTTP 認証方法は次のとおりです: CURLAUTH_BASIC、CURLAUTH_DIGEST、CURLAUTH_GSSNEGOTIATE、CURLAUTH_NTLM、CURLAUTH_ANY、および CURLAUTH_ANYSAFE。
| ビットフィールド (または) 演算子を使用して複数の値を区切ることができ、cURL はサーバーに最適なものを選択させます。
CURLAUTH_ANY は CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE と同等です。
CURLAUTH_ANYSAFE は CURLAUTH_DIGEST と同等です。
アップロードされるファイルのサイズ制限をバイト単位で設定します。
CURLOPT_LOW_SPEED_LIMIT
転送速度が CURLOPT_LOW_SPEED_LIMIT (バイト/秒) 未満の場合、PHP は CURLOPT_LOW_SPEED_TIME を使用して、遅すぎるため転送をキャンセルするかどうかを決定します。
CURLOPT_LOW_SPEED_TIME
転送速度が CURLOPT_LOW_SPEED_LIMIT (バイト/秒) 未満の場合、PHP は CURLOPT_LOW_SPEED_TIME を使用して、遅すぎるため転送をキャンセルするかどうかを決定します。
CURLOPT_MAXCONNECTS
許可される接続の最大数を超えた場合、CURLOPT_CLOSEPOLICY を使用してどの接続を停止するかが決定されます。
CURLOPT_MAXREDIRS
このオプションは、CURLOPT_FOLLOWLOCATION と一緒に使用されます。
CURLOPT_PORT
は接続ポートを指定するために使用されます。 (オプション)
CURLOPT_PROTOCOLS
CURLPROTO_* へのビットフィールド参照。有効にすると、ビットフィールド値によって、libcurl が転送中に使用できるプロトコルが制限されます。これにより、多くのプロトコルをサポートするように libcurl をコンパイルできるようになりますが、使用できるのはそれらのサブセットのみです。デフォルトでは、libcurl はサポートするすべてのプロトコルを使用します。 CURLOPT_REDIR_PROTOCOLS を参照してください。使用可能なプロトコルオプションは次のとおりです: CURLPROTO_HTTP、CURLPROTO_HTTPS、CURLPROTO_FTP、CURLPROTO_FTPS、CURLPROTO_SCP、CURLPROTO_SFTP、CURLPROTO_TELNET、CURLPROTO_LDAP、CURLPROTO_LDAPS、CURLPROTO_DICT、CURLPROTO_FILE、CURLPROTO_TF TP、 PROTO_ALL
は cURL 7.19.4 で追加されました。

CURLOPT_PROXYAUTH

HTTPプロキシ接続の検証方法。 CURLOPT_HTTPAUTH のビットフィールドフラグを使用して、対応するオプションを設定します。プロキシ認証については、現在 CURLAUTH_BASIC と CURLAUTH_NTLM のみがサポートされています。 cURL 7.10.7 で追加されました。

CURLOPT_PROXYPORT

プロキシサーバーのポート。ポートは CURLOPT_PROXY で設定することもできます。
CURLOPT_PROXYTYPE
は、CURLPROXY_HTTP (デフォルト) または CURLPROXY_SOCKS5 のいずれかです。 cURL 7.10 で追加されました。

CURLOPT_REDIR_PROTOCOLS

CURLPROTO_* のビットフィールド値。有効にすると、CURLOPT_FOLLOWLOCATION がオンになっている場合に、リダイレクトを追跡するときにトランスポートスレッドが使用できるプロトコルがビットフィールド値によって制限されます。これにより、リダイレクト時にトランスポートスレッドを許可されたプロトコルのサブセットに制限できるようになります。デフォルトでは、libcurl は FILE と SCP を除くすべてのプロトコルを許可します。これは、サポートされているすべてのプロトコルに無条件で従う 7.19.4 プレリリースバージョンとは少し異なります。プロトコル定数については、CURLOPT_PROTOCOLS を参照してください。 cURL 7.19.4 で追加されました。

CURLOPT_RESUME_FROM

送信再開時にバイトオフセットを渡します(送信再開に使用します)。
CURLOPT_SSL_VERIFYHOST
1 サーバーSSL証明書に共通名があるかどうかを確認します。翻訳者注: 一般名とは、通常、SSL 証明書を申請するドメイン名 (ドメイン) またはサブドメイン (サブドメイン) を入力することを意味します。 2 共通名が存在し、指定されたホスト名と一致することを確認します。
CURLOPT_SSLVERSION
使用される SSL バージョン (2 または 3)。デフォルトでは、PHP はこの値を自動的に検出しますが、場合によっては手動で設定する必要がある場合があります。
CURLOPT_TIMECONDITION
CURLOPT_TIMEVALUE で指定された特定の時間後に編集された場合は、CURL_TIMECOND_IFMODSINCE を使用してページを返します。ページが変更されておらず、CURLOPT_HEADER が true の場合は、「304 Not Modified」ヘッダーが false として返されます。次に、CURL_TIMECOND_IFUNMODSINCE を使用します。デフォルト値は CURL_TIMECOND_IFUNMODSINCE です。
CURLOPT_TIMEOUT
cURL の実行が許可される最大秒数を設定します。
CURLOPT_TIMEOUT_MS
cURL の実行が許可される最大時間をミリ秒単位で設定します。
cURL 7.16.2 で追加されました。 PHP 5.2.3 以降で利用可能です。

CURLOPT_TIMEVALUE
CURLOPT_TIMECONDITION で使用されるタイムスタンプを設定します。デフォルトでは、CURL_TIMECOND_IFMODSINCE が使用されます。

カテゴリ 3:
以下のオプションのオプションのパラメータの値は、文字列型の値に設定する必要があります:
オプション
オプションの値
備考

CURLOPT_CAINFO
1 つは 1 を保持します 1 つのファイル名サーバーによる検証に使用される複数の証明書。このパラメータは、CURLOPT_SSL_VERIFYPEER とともに使用した場合にのみ意味を持ちます。 .
CURLOPT_CAPATH
複数の CA 証明書を保持するディレクトリ。このオプションは CURLOPT_SSL_VERIFYPEER とともに使用されます。
CURLOPT_COOKIE
HTTPリクエストの「Cookie:」部分の内容を設定します。複数の Cookie はセミコロンとそれに続くスペースで区切られます (たとえば、「fruit=apple; color=red」)。
CURLOPT_COOKIEFILE
Cookie データを含むファイル名は、Netscape 形式にすることも、単純な HTTP ヘッダー情報をファイルに保存することもできます。
CURLOPT_COOKIEJAR
接続完了後にCookie情報を保存するファイル。
CURLOPT_CUSTOMREQUEST
HTTP リクエストとして「GET」または「HEAD」の代わりにカスタムリクエストメッセージを使用します。これは、「DELETE」またはその他の秘密の HTTP リクエストを実行する場合に役立ちます。有効な値は「GET」、「POST」、「CONNECT」などです。つまり、HTTP リクエスト全体をここに入力しないでください。たとえば、「GET /index.html HTTP/1.0rnrn」と入力するのは誤りです。
注:
サーバーがサポートしていることを確認するまで、このカスタムリクエストメソッドを使用しないでください。

CURLOPT_EGDSOCKET
エントロピー収集デーモンソケットを除き、CURLOPT_RANDOM_FILE に似ています。
CURLOPT_ENCODING
HTTP リクエストヘッダーの「Accept-Encoding:」の値。サポートされているエンコーディングは「identity」、「deflate」、「gzip」です。空の文字列「」の場合、リクエストヘッダーはサポートされているすべてのエンコードタイプを送信します。
cURL 7.10 で追加されました。

CURLOPT_FTPPORT
この値は、FTP の「POST」コマンドに必要な IP アドレスを取得するために使用されます。「POST」コマンドは、指定した IP アドレスに接続するようにリモートサーバーに指示します。この文字列には、プレーンテキストの IP アドレス、ホスト名、ネットワークインターフェイス名 (UNIX の場合)、またはデフォルトの IP アドレスを使用するための単なる「-」を指定できます。
CURLOPT_INTERFACE
ネットワーク送信インターフェース名。インターフェース名、IP アドレス、またはホスト名を指定できます。
CURLOPT_KRB4LEVEL
KRB4 (Kerberos 4) セキュリティレベル。「clear」、「safe」、「confidential」、「private」のいずれかの値が有効です (最小値から最大値の順)。文字列がこれらのいずれにも一致しない場合は、「private」が使用されます。このオプションを NULL に設定すると、KRB4 セキュリティ認証が無効になります。現在、KRB4 セキュリティ認証は FTP 転送にのみ使用できます。
CURLOPT_POSTFIELDS
すべてのデータは、HTTP プロトコルの「POST」操作を使用して送信されます。ファイルを送信するには、ファイル名の前に @ を付け、フルパスを使用します。このパラメーターは、「para1=val1¶2=val2&...」のような URL コード化された文字列、またはフィールド名をキーとして、フィールドデータを値として持つ配列を通じて渡すことができます。 value が配列の場合、Content-Type ヘッダーは multipart/form-data に設定されます。
CURLOPT_PROXY
HTTP プロキシチャネル。
CURLOPT_PROXYUSERPWD
プロキシへの接続に使用される「[ユーザー名]:[パスワード]」形式の文字列。
CURLOPT_RANDOM_FILE
SSL 乱数シードの生成に使用されるファイル名。
CURLOPT_RANGE
「X-Y」の形式で、X と Y はオプションで、データの範囲をバイト単位で取得します。 HTTP トランスポートスレッドは、「X-Y,N-M」などのカンマで区切られたこのような複数の重複もサポートします。
CURLOPT_REFERER
HTTPリクエストヘッダーの「Referer:」の内容。
CURLOPT_SSL_CIPHER_LIST
SSL 暗号化アルゴリズムのリスト。たとえば、RC4-SHA と TLSv1 は、使用可能な暗号化リストの 1 つです。
CURLOPT_SSLCERT
PEM 形式の証明書を含むファイル名。
CURLOPT_SSLCERTPASSWD
CURLOPT_SSLCERT 証明書を使用するために必要なパスワード。
CURLOPT_SSLCERTTYPE
証明書の種類。サポートされている形式は、「PEM」（デフォルト）、「DER」、および「ENG」です。
cURL 7.9.3 で追加されました。

CURLOPT_SSLENGINE
CURLOPT_SSLKEY で指定された SSL 秘密キーに使用される暗号化エンジン変数。
CURLOPT_SSLENGINE_DEFAULT
非対称暗号化操作に使用される変数。
CURLOPT_SSLKEY
SSL 秘密キーを含むファイルの名前。
CURLOPT_SSLKEYPASSWD
CURLOPT_SSLKEY で指定された SSL 秘密キーのパスワード。
注:
このオプションには機密のパスワード情報が含まれているため、この PHP スクリプトを安全に保管してください。

CURLOPT_SSLKEYTYPE
CURLOPT_SSLKEYで指定された秘密鍵の暗号化タイプは、「PEM」(デフォルト値)、「DER」、「ENG」です。
CURLOPT_URL
取得するURLアドレスはcurl_init()関数でも設定できます。
CURLOPT_USERAGENT
HTTP リクエストに「User-Agent:」ヘッダー文字列が含まれます。
CURLOPT_USERPWD
接続に必要なユーザー名とパスワードを「[ユーザー名]:[パスワード]」の形式で渡します。

カテゴリ 4
以下のオプションのオプションのパラメータの値は、配列に設定する必要があります:
Options
オプションの値 value
備考

CURLOPT_HTTP200ALIASES
200 応答コード配列、配列内応答は正しい応答とみなされ、そうでない場合はエラーとみなされます。
cURL 7.10.3 で追加されました。

CURLOPT_HTTPHEADER
HTTP ヘッダーフィールドの設定に使用される配列。次の形式の配列を使用して設定します: array('Content-type: text/plain', 'Content-length: 100')
CURLOPT_POSTQUOTE
FTP リクエストの完了後にサーバー上で実行される一連の FTP コマンド。
CURLOPT_QUOTE
FTP リクエストの前にサーバー上で実行される一連の FTP コマンド。

次のオプションのオプションのパラメータの場合、値はストリームリソースに設定する必要があります (たとえば、fopen() を使用):
オプション
オプションの値

CURLOPT_FILE
出力ファイルの場所を設定します。値は次のとおりです。リソースタイプ。デフォルトは STDOUT (ブラウザ) です。

CURLOPT_INFILE
ファイルをアップロードするときに読み取る必要があるファイルアドレス。値はリソースタイプです。

CURLOPT_STDERR
エラー出力アドレスを設定します。値はリソースタイプであり、デフォルトの STDERR を置き換えます。

CURLOPT_WRITEHEADER
ヘッダー部分が書き込まれるファイルアドレスを設定します。値はリソースタイプです。

以下のオプションのオプションのパラメータの値は、コールバック関数名に設定する必要があります:
オプション
オプションの値

CURLOPT_HEADERFUNCTION
この関数には 2 つのパラメータがあり、最初のパラメータはリソースハンドルです。 2 番目は出力ヘッダーデータです。ヘッダーデータの出力は、書き込まれたデータのサイズを返すこの関数に依存する必要があります。

CURLOPT_PASSWDFUNCTION
3 つのパラメーターを使用してコールバック関数を設定します。最初のパラメーターは cURL リソースハンドル、2 番目はパスワードプロンプト、3 番目のパラメーターは許可されるパスワードの最大長です。パスワードの値を返します。

CURLOPT_PROGRESSFUNCTION
3 つのパラメーターを使用してコールバック関数を設定します。1 つ目は cURL リソースハンドル、2 つ目はファイル記述子リソース、3 つ目は長さです。含まれているデータを返します。

CURLOPT_READFUNCTION
コールバック関数には 2 つのパラメーターがあり、最初のパラメーターはセッションハンドルで、2 番目のパラメーターは HTTP 応答ヘッダー情報の文字列です。この関数を使用すると、返されたデータが自分で処理されます。戻り値はデータサイズ (バイト単位) です。 0 を返すと EOF 信号を表します。

CURLOPT_WRITEFUNCTION
には 2 つのパラメーターを持つコールバック関数があり、最初のパラメーターはセッションハンドル、2 番目のパラメーターは HTTP 応答ヘッダー情報の文字列です。このコールバック関数を使用すると、応答ヘッダー情報が単独で処理されます。応答ヘッダー情報は文字列全体です。戻り値を、書き込まれた文字列の正確な長さに設定します。エラーが発生すると、トランスポートスレッドは終了します。