svn: /phpdoc/ja/trunk/reference/curl/functions/ curl-setopt.xml

Modified: phpdoc/ja/trunk/reference/curl/functions/curl-setopt.xml
===================================================================
--- phpdoc/ja/trunk/reference/curl/functions/curl-setopt.xml	2020-02-06 23:22:18 UTC (rev 349156)
+++ phpdoc/ja/trunk/reference/curl/functions/curl-setopt.xml	2020-02-07 00:24:06 UTC (rev 349157)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 349125 Maintainer: takagi Status: working -->
+<!-- EN-Revision: 349125 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,mumumu -->
 <refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -1050,22 +1050,23 @@
            </entry>
           </row>
           <row>
-           <!-- to be translated -->
            <entry valign="top"><constant>CURLOPT_PROXY_SSL_OPTIONS</constant></entry>
            <entry valign="top">
-            Set proxy SSL behavior options, which is a bitmask of any of the following constants:
+            HTTPSプロキシの振る舞いを設定するオプションです。
+            これは以下の定数のうち、任意のものを組み合わせたビットマスクです:
             <simpara>
-             <constant>CURLSSLOPT_ALLOW_BEAST</constant>: do not attempt to use
-             any workarounds for a security flaw in the SSL3 and TLS1.0 protocols.
+             <constant>CURLSSLOPT_ALLOW_BEAST</constant>:
+             SSL3 と TLS1.0 プロトコルに存在する脆弱性を回避するための回避策を使いません。
             </simpara>
             <simpara>
-             <constant>CURLSSLOPT_NO_REVOKE</constant>: disable certificate
-             revocation checks for those SSL backends where such behavior is
-             present. (curl >= 7.44.0)
+             <constant>CURLSSLOPT_NO_REVOKE</constant>:
+             SSLバックエンドの証明書の失効チェックを無効にします。
+             但し、そうした振る舞いが存在した場合に限ります(curl >= 7.44.0)
             </simpara>
             <simpara>
-             <constant>CURLSSLOPT_NO_PARTIALCHAIN</constant>: do not accept "partial"
-             certificate chains, which it otherwise does by default. (curl >= 7.68.0)
+             <constant>CURLSSLOPT_NO_PARTIALCHAIN</constant>:
+             "部分的な"証明書チェインを許可しません。
+             デフォルトでは許可されています(curl >= 7.68.0)
             </simpara>
            </entry>
            <entry valign="top">
@@ -1535,21 +1536,20 @@
            </entry>
           </row>
           <row>
-           <!--  to be translated -->
            <entry valign="top"><constant>CURLOPT_PRE_PROXY</constant></entry>
            <entry valign="top">
-            Set a <type>string</type> holding the host name or dotted numerical
-            IP address to be used as the preproxy that curl connects to before
-            it connects to the HTTP(S) proxy specified in the
-            <constant>CURLOPT_PROXY</constant> option for the upcoming request.
-            The preproxy can only be a SOCKS proxy and it should be prefixed with
-            <literal>[scheme]://</literal> to specify which kind of socks is used.
-            A numerical IPv6 address must be written within [brackets].
-            Setting the preproxy to an empty string explicitly disables the use of a preproxy.
-            To specify port number in this string, append <literal>:[port]</literal>
-            to the end of the host name. The proxy's port number may optionally be
-            specified with the separate option <constant>CURLOPT_PROXYPORT</constant>.
-            Defaults to using port 1080 for proxies if a port is not specified.
+            <constant>CURLOPT_PROXY</constant> で指定された HTTP(S) プロキシにcurlが接続する前に、
+            事前に接続する preproxy を設定します。
+            この値には、ホスト名またはドットで区切られた数値のIPアドレスを設定します。
+            preproxy は SOCKS プロキシだけがなることができ、
+            どの socks を使うかを指定するために <literal>[scheme]://</literal> を先頭に付けます。
+            数値の IPv6 アドレスは 角括弧 "[]" 内に書かなければいけません。
+            preproxy にから文字列を設定すると、明示的に preproxy を無効にできます。
+            この文字列にポート番号を設定するには、
+            ホスト名の最後に <literal>:[port]</literal> を追加します。
+            プロキシのポート番号は別のオプション <constant>CURLOPT_PROXYPORT</constant>
+            で指定しても構いません。ポート番号を指定しない場合は、
+            デフォルトでは 1080 を使います。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1573,15 +1573,15 @@
            </entry>
           </row>
           <row>
-           <!-- to be translated -->
            <entry valign="top"><constant>CURLOPT_PROXY_CAINFO</constant></entry>
            <entry valign="top">
-            The path to proxy Certificate Authority (CA) bundle. Set the path as a
-            <type>string</type> naming a file holding one or more certificates to
-            verify the HTTPS proxy with.
-            This option is for connecting to an HTTPS proxy, not an HTTPS server.
-            Defaults set to the system path where libcurl's cacert bundle is assumed
-            to be stored.
+            証明書認証局(CA)バンドルのパス。
+            HTTPS プロキシを検証するためのひとつ以上の証明書を持つファイル名のパスを
+            <type>string</type> で設定します。
+            このオプションはHTTPSプロキシに接続するためのもので、
+            HTTPSサーバに接続するためのものではありません。
+            デフォルトでは、libcurl の cacert バンドルが保存されていると想定されている
+            システムパスが設定されます。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1590,7 +1590,7 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_CAPATH</constant></entry>
            <entry valign="top">
-            The directory holding multiple CA certificates to verify the HTTPS proxy with.
+            HTTPSプロキシを検証するための複数のCA証明書が置かれたディレクトリ。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1599,9 +1599,9 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_CRLFILE</constant></entry>
            <entry valign="top">
-            Set the file name with the concatenation of CRL (Certificate Revocation List)
-            in PEM format to use in the certificate validation that occurs during
-            the SSL exchange.
+            PEMフォーマットの CRL (Certificate Revocation List, 証明書失効リスト)
+            を連結したファイル名を設定します。
+            これはSSL通信の際に行われる証明書の検証に使います。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1610,10 +1610,12 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_KEYPASSWD</constant></entry>
            <entry valign="top">
-            Set the string be used as the password required to use the
-            <constant>CURLOPT_PROXY_SSLKEY</constant> private key. You never needed a
-            passphrase to load a certificate but you need one to load your private key.
-            This option is for connecting to an HTTPS proxy, not an HTTPS server.
+            <constant>CURLOPT_PROXY_SSLKEY</constant> で設定する秘密鍵で使う、
+            必須のパスワードを設定します。
+            証明書を読み込むのにパスフレーズは不要ですが、
+            秘密鍵を読み込むにはパスフレーズが必要です。
+            このオプションはHTTPSプロキシに接続するために必要です。
+            HTTPSサーバに接続するためのものではありません。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1622,10 +1624,11 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_PINNEDPUBLICKEY</constant></entry>
            <entry valign="top">
-            Set the pinned public key for HTTPS proxy. The string can be the file name
-            of your pinned public key. The file format expected is "PEM" or "DER".
-            The string can also be any number of base64 encoded sha256 hashes preceded by
-            "sha256//" and separated by ";"
+            HTTPSプロキシ向けの pinned public key を設定します。
+            pinned public key のファイル名を文字列で設定できます。
+            ファイルフォーマットは "PEM" または "DER" です。
+            base64 エンコードされた sha256 ハッシュ を任意の数だけ
+            "sha256//" の後に続けることもできます。このハッシュは ";" で区切ります。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1634,13 +1637,14 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_SSLCERT</constant></entry>
            <entry valign="top">
-            The file name of your client certificate used to connect to the HTTPS proxy.
-            The default format is "P12" on Secure Transport and "PEM" on other engines,
-            and can be changed with <constant>CURLOPT_PROXY_SSLCERTTYPE</constant>.
-            With NSS or Secure Transport, this can also be the nickname of the certificate
-            you wish to authenticate with as it is named in the security database.
-            If you want to use a file from the current directory, please precede it with
-            "./" prefix, in order to avoid confusion with a nickname.
+            HTTPSプロキシに接続する時に使うクライアント証明書のフォーマット。
+            デフォルトは Secure Transport の場合 "P12" で、
+            それ以外のエンジンでは "PEM" ですが、
+            <constant>CURLOPT_PROXY_SSLCERTTYPE</constant> でも変更できます。
+            NSS や Secure transport では、
+            セキュリティデータベースで名付けられた証明書のニックネームも設定できます。
+            現在のディレクトリにあるファイルを使いたい場合は、
+            ニックネームとの混乱を避けるため "./" をプレフィックスとして付けてください。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1649,11 +1653,12 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_SSLCERTTYPE</constant></entry>
            <entry valign="top">
-            The format of your client certificate used when connecting to an HTTPS proxy.
-            Supported formats are "PEM" and "DER", except with Secure Transport.
-            OpenSSL (versions 0.9.3 and later) and Secure Transport
-            (on iOS 5 or later, or OS X 10.7 or later) also support "P12" for
-            PKCS#12-encoded files. Defaults to "PEM".
+            HTTPSプロキシに接続する時に使うクライアント証明書のフォーマット。
+            サポートされているのは "PEM" と "DER" ですが、
+            Secure Transport はこれらをサポートしていません。
+            OpenSSL (0.9.3 以降) と Secure Transport
+            (iOS 5 以降, または OS X 10.7 以降) では PKCS#12-encoded ファイル向けに
+            "P12" もサポートしています。デフォルトは "PEM" です。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1662,10 +1667,11 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant></entry>
            <entry valign="top">
-            The list of ciphers to use for the connection to the HTTPS proxy.
-            The list must be syntactically correct, it consists of one or more cipher
-            strings separated by colons. Commas or spaces are also acceptable separators
-            but colons are normally used, !, - and + can be used as operators.
+            HTTPSプロキシと接続を確立するために使う暗号スイートの一覧。
+            この一覧はひとつ以上の暗号スイートの文字列がコロンで区切られており、
+            構文的に正しくなければなりません。
+            コンマやスペースも区切り文字としては有効ですが、通常はコロンが使われます。
+            !, - および + が演算子として使えます。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1674,12 +1680,13 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_TLS13_CIPHERS</constant></entry>
            <entry valign="top">
-            The list of cipher suites to use for the TLS 1.3 connection to a proxy.
-            The list must be syntactically correct, it consists of one or more
-            cipher suite strings separated by colons. This option is currently used
-            only when curl is built to use OpenSSL 1.1.1 or later.
-            If you are using a different SSL backend you can try setting
-            TLS 1.3 cipher suites by using the <constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant> option.
+            TLS 1.3 接続をプロキシと確立するために使う暗号スイートの一覧。
+            この一覧はひとつ以上の暗号スイートの文字列がコロンで区切られており、
+            構文的に正しくなければなりません。
+            現状、このオプションはcurlが OpenSSL 1.1.1 以降とビルドされた時にだけ使われています。
+            OpenSSL 以外のSSLバックエンドを使っている場合は、
+            <constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant> オプションを使って
+            TLS 1.3 の暗号スイートを設定できます。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.61.0 と OpenSSL >= 1.1.1 をビルドした場合に使用可能です。
@@ -1688,19 +1695,21 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_SSLKEY</constant></entry>
            <entry valign="top">
-            The file name of your private key used for connecting to the HTTPS proxy.
-            The default format is "PEM" and can be changed with
-            <constant>CURLOPT_PROXY_SSLKEYTYPE</constant>.
-            (iOS and Mac OS X only) This option is ignored if curl was built against Secure Transport.
+            HTTPSプロキシに接続するのに使う秘密鍵のファイル名。
+            デフォルトのフォーマットは "PEM" で、
+            そのフォーマットは <constant>CURLOPT_PROXY_SSLKEYTYPE</constant> で変更できます。
+            (iOS と Mac OS X のみ) Secure Transport を使って curl がビルドされている場合、
+            このオプションは無視されます。
            </entry>
            <entry valign="top">
-            PHP 7.3.0 以降 および cURL >= 7.61.0 をビルドした場合、かつ TLS が有効な場合にのみ使用可能です。
+            PHP 7.3.0 以降 および cURL >= 7.61.0 をビルドした場合、
+            かつ TLS が有効な場合にのみ使用可能です。
            </entry>
           </row>
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_SSLKEYTYPE</constant></entry>
            <entry valign="top">
-            The format of your private key. Supported formats are "PEM", "DER" and "ENG".
+            秘密鍵のフォーマット。"PEM", "DER" および "ENG" がサポートされています。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1709,9 +1718,9 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant></entry>
            <entry valign="top">
-            The password to use for the TLS authentication method specified with the
-            <constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant> option. Requires that the
-            <constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant> option to also be set.
+            <constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant> オプションで指定したTLS認証メソッド
+            で使うパスワード。
+            <constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant> オプションも設定する必要があります。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1720,13 +1729,16 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant></entry>
            <entry valign="top">
-            The method of the TLS authentication used for the HTTPS connection. Supported method is "SRP".
+            HTTPS接続で使うTLS認証メソッド。
+            "SRP" がサポートされています。
             <note>
              <para>
-              Secure Remote Password (SRP) authentication for TLS provides mutual authentication
-              if both sides have a shared secret. To use TLS-SRP, you must also set the
-              <constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant> and
-              <constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant> options.
+              TLS の Secure Remote Password (SRP) 認証は、
+              ローカルとリモートの双方が共通のシークレットを持っている場合に、
+              お互いを認証する方法を提供します。
+              TLS-SRP を使うためには、
+              <constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant> と
+              <constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant> オプションも設定する必要があります。
              </para>
             </note>
            </entry>
@@ -1737,9 +1749,9 @@
           <row>
            <entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant></entry>
            <entry valign="top">
-            Tusername to use for the HTTPS proxy TLS authentication method specified with the
-            <constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant> option. Requires that the
-            <constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant> option to also be set.
+            <constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant> オプションで指定された
+            HTTPSプロキシのTLS認証メソッドで使うユーザー名。
+            <constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant> オプションも設定する必要があります。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.52.0 をビルドした場合に使用可能です。
@@ -1916,14 +1928,14 @@
            </entry>
           </row>
           <row>
-           <!-- to be translated -->
            <entry valign="top"><constant>CURLOPT_TLS13_CIPHERS</constant></entry>
            <entry valign="top">
-            The list of cipher suites to use for the TLS 1.3 connection. The list must be
-            syntactically correct, it consists of one or more cipher suite strings separated by colons.
-            This option is currently used only when curl is built to use OpenSSL 1.1.1 or later.
-            If you are using a different SSL backend you can try setting
-            TLS 1.3 cipher suites by using the <constant>CURLOPT_SSL_CIPHER_LIST</constant> option.
+            TLS 1.3 接続を確立するために使う暗号スイートの一覧。
+            この一覧はひとつ以上の暗号スイートの文字列がコロンで区切られており、
+            構文的に正しくなければなりません。
+            このオプションは現状、OpenSSL 1.1.1 以降でcurlがビルドされている場合にだけ使われています。
+            他のSSLバックエンドを使っている場合、
+            <constant>CURLOPT_SSL_CIPHER_LIST</constant> を使うと TLS 1.3 の暗号スイートを設定できます。
            </entry>
            <entry valign="top">
             PHP 7.3.0 以降 および cURL >= 7.61.0 と OpenSSL >= 1.1.1 をビルドした場合に使用可能です。