From 90e881c8512b797dd7f1edad0108529dadaaa19d Mon Sep 17 00:00:00 2001 From: nsfisis Date: Fri, 2 May 2025 20:57:23 +0900 Subject: [PATCH 1/7] =?UTF-8?q?=E7=BF=BB=E8=A8=B3=E8=80=85=E3=81=AB=20Kens?= =?UTF-8?q?uke=20Imamura=20(nsfisis)=20=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translation.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/translation.xml b/translation.xml index 30983a198a..e324970f31 100644 --- a/translation.xml +++ b/translation.xml @@ -32,6 +32,7 @@ + From 7f93c64d22c5f48cacc13ab2b376bb11b5d0414a Mon Sep 17 00:00:00 2001 From: nsfisis Date: Fri, 2 May 2025 20:37:47 +0900 Subject: [PATCH 2/7] =?UTF-8?q?=E6=9C=AA=E8=A8=B3=E3=83=95=E3=82=A1?= =?UTF-8?q?=E3=82=A4=E3=83=AB=20reference/curl/constants=5Fcurl=5Fsetopt.x?= =?UTF-8?q?ml=20=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/curl/constants_curl_setopt.xml | 4682 ++++++++++++++++++++++ 1 file changed, 4682 insertions(+) create mode 100644 reference/curl/constants_curl_setopt.xml diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml new file mode 100644 index 0000000000..0698f56754 --- /dev/null +++ b/reference/curl/constants_curl_setopt.xml @@ -0,0 +1,4682 @@ + + + + + <function>curl_setopt</function> + + + CURLOPT_ABSTRACT_UNIX_SOCKET + (int) + + + + Enables the use of an abstract Unix domain socket instead of + establishing a TCP connection to a host and sets the path to + the given string. This option shares the same semantics + as CURLOPT_UNIX_SOCKET_PATH. These two options + share the same storage and therefore only one of them can be set + per handle. + Available as of PHP 7.3.0 and cURL 7.53.0. + + + + + + CURLOPT_ACCEPT_ENCODING + (int) + + + + Sets a string with the contents + of the Accept-Encoding: header sent in an HTTP request. + Set to &null; to disable sending the Accept-Encoding: header. + Defaults to &null;. + Available as of cURL 7.21.6. + + + + + + CURLOPT_ACCEPTTIMEOUT_MS + (int) + + + + The maximum number of milliseconds to wait for a server + to connect back to cURL when an active FTP connection is used. + This option accepts any value that can be cast to a valid int. + Defaults to 60000 milliseconds. + Available as of cURL 7.24.0. + + + + + + CURLOPT_ADDRESS_SCOPE + (int) + + + + The scope id value to use when connecting to IPv6 addresses. + This option accepts any value that can be cast to a valid int. + Defaults to 0. + Available as of cURL 7.19.0. + + + + + + CURLOPT_ALTSVC + (int) + + + + Pass a string with the filename for cURL to use as the Alt-Svc cache file to read existing cache contents from and + possibly also write it back to a after a transfer, unless CURLALTSVC_READONLYFILE + is set via CURLOPT_ALTSVC_CTRL. + Available as of PHP 8.2.0 and cURL 7.64.1. + + + + + + CURLOPT_ALTSVC_CTRL + (int) + + + + Populate the bitmask with the correct set of features to instruct cURL how to handle Alt-Svc for the + transfers using this handle. cURL only accepts Alt-Svc headers over HTTPS. It will also only complete + a request to an alternative origin if that origin is properly hosted over HTTPS. + Setting any bit will enable the alt-svc engine. + Set to any of the + CURLALTSVC_* constants. + Defaults to Alt-Svc handling being disabled. + Available as of PHP 8.2.0 and cURL 7.64.1. + + + + + + CURLOPT_APPEND + (int) + + + + Setting this option to 1 will cause FTP uploads + to append to the remote file instead of overwriting it. + Defaults to 0. + Available as of cURL 7.17.0. + + + + + + CURLOPT_AUTOREFERER + (int) + + + + &true; to automatically set the Referer: field in + requests where it follows a Location: redirect. + Defaults to 0. + Available as of cURL 7.1.0. + + + + + + CURLOPT_AWS_SIGV4 + (int) + + + + Provides AWS V4 signature authentication on HTTP(S) header as a string. + This option overrides any other authentication types that have been set in + CURLOPT_HTTPAUTH. This method cannot be combined with other authentication types. + Available as of PHP 8.2.0 and cURL 7.75.0. + + + + + + CURLOPT_BINARYTRANSFER + (int) + + + + This constant is no longer used as of PHP 5.5.0. + Deprecated as of PHP 8.4.0. + + + + + + CURLOPT_BUFFERSIZE + (int) + + + + The size of the buffer to use for each read. There is no guarantee + this request will be fulfilled, however. + This option accepts any value that can be cast to a valid int. + Defaults to CURL_MAX_WRITE_SIZE (currently, 16kB). + Available as of cURL 7.10. + + + + + + CURLOPT_CAINFO + (int) + + + + A string with the name of a file holding one or more certificates to verify the + peer with. This only makes sense when used in combination with + CURLOPT_SSL_VERIFYPEER. Might require an absolute path. + Available as of cURL 7.4.2. + + + + + + CURLOPT_CAINFO_BLOB + (int) + + + + A string with the name of a PEM file holding one or more certificates to verify the + peer with. This option overrides CURLOPT_CAINFO. + Available as of PHP 8.2.0 and cURL 7.77.0. + + + + + + CURLOPT_CAPATH + (int) + + + + A string with a directory that holds multiple CA certificates. + Use this option alongside CURLOPT_SSL_VERIFYPEER. + Available as of cURL 7.9.8. + + + + + + CURLOPT_CA_CACHE_TIMEOUT + (int) + + + + Sets the maximum time in seconds any in memory cached CA certificate store + may be kept and reused for new connections. + This option accepts any value that can be cast to a valid int. + Defaults to 86400 (24 hours). + Available as of PHP 8.3.0 and cURL 7.87.0 + + + + + + CURLOPT_CERTINFO + (int) + + + + &true; to output SSL certification information to STDERR + on secure transfers. + Requires CURLOPT_VERBOSE to be on to have an effect. + Defaults to &false;. + Available as of cURL 7.19.1. + + + + + + CURLOPT_CONNECTTIMEOUT + (int) + + + + The number of seconds to wait while trying to connect. Use 0 to + wait indefinitely. + This option accepts any value that can be cast to a valid int. + Defaults to 300. + Available as of cURL 7.7.0. + + + + + + CURLOPT_CONNECTTIMEOUT_MS + (int) + + + + The number of milliseconds to wait while trying to connect. + Use 0 to wait indefinitely. + If cURL is built to use the standard system name resolver, that + portion of the connect will still use full-second resolution for + timeouts with a minimum timeout allowed of one second. + This option accepts any value that can be cast to a valid int. + Defaults to 300000. + Available as of cURL 7.16.2. + + + + + + CURLOPT_CONNECT_ONLY + (int) + + + + &true; tells the library to perform all the required proxy authentication + and connection setup, but no data transfer. This option is implemented for + HTTP, SMTP and POP3. + Defaults to &false;. + Available as of cURL 7.15.2. + + + + + + CURLOPT_CONNECT_TO + (int) + + + + Connect to a specific host and port instead of the URL's host and port. + Accepts an array of strings with the format + HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. + Available as of PHP 7.0.7 and cURL 7.49.0. + + + + + + CURLOPT_COOKIE + (int) + + + + A string with the contents of the Cookie: header to be used in the HTTP request. + Note that multiple cookies are separated with a semicolon followed + by a space (e.g., fruit=apple; colour=red). + Available as of cURL 7.1.0. + + + + + + CURLOPT_COOKIEFILE + (int) + + + + A string with the name of the file containing the cookie data. + The cookie file can be in Netscape format, or just plain HTTP-style headers dumped into a file. + If the name is an empty string, no cookies are loaded, but cookie + handling is still enabled. + Available as of cURL 7.1.0. + + + + + + CURLOPT_COOKIEJAR + (int) + + + + A string with the name of a file to save all internal cookies to when + the handle's destructor is called. + Available as of cURL 7.9.0. + + + As of PHP 8.0.0, curl_close is a no-op + and does not destroy the handle. + If cookies need to be written prior to the handle being automatically + destroyed, call unset on the handle. + + + + + + + + CURLOPT_COOKIELIST + (int) + + + + A cookie string (i.e. a single line in Netscape/Mozilla format, or a regular + HTTP-style Set-Cookie header) adds that single cookie to the internal cookie store. + + + ALL + erases all cookies held in memory + + + SESS + erases all session cookies held in memory + + + FLUSH + writes all known cookies to the file specified by CURLOPT_COOKIEJAR + + + RELOAD + loads all cookies from the files specified by CURLOPT_COOKIEFILE + + . + Available as of cURL 7.14.1. + + + + + + CURLOPT_COOKIESESSION + (int) + + + + &true; to mark this as a new cookie "session". It will force cURL + to ignore all cookies it is about to load that are "session cookies" + from the previous session. By default, cURL always stores and + loads all cookies, independent if they are session cookies or not. + Session cookies are cookies without expiry date and they are meant + to be alive and existing for this "session" only. + Available as of cURL 7.9.7. + + + + + + CURLOPT_CRLF + (int) + + + + &true; to convert Unix newlines to CRLF newlines + on transfers. + Available as of cURL 7.1.0. + + + + + + CURLOPT_CRLFILE + (int) + + + + Pass a string naming a file with the concatenation of + CRL (Certificate Revocation List) (in PEM format) + to use in the certificate validation that occurs during the SSL exchange. + When cURL is built to use GnuTLS, + there is no way to influence the use of CRL passed + to help in the verification process. + When cURL is built with OpenSSL support, + X509_V_FLAG_CRL_CHECK + and X509_V_FLAG_CRL_CHECK_ALL are both set, + requiring CRL check against all the elements of the certificate chain + if a CRL file is passed. + Also note that CURLOPT_CRLFILE implies + CURLSSLOPT_NO_PARTIALCHAIN + as of cURL 7.71.0 due to an OpenSSL bug. + Available as of cURL 7.19.0. + + + + + + CURLOPT_CUSTOMREQUEST + (int) + + + + A custom request method to use instead of + GET or HEAD when doing + a HTTP request. This is useful for doing + DELETE or other, more obscure HTTP requests. + Valid values are things like GET, + POST, CONNECT and so on; + i.e. Do not enter a whole HTTP request line here. For instance, + entering GET /index.html HTTP/1.0\r\n\r\n + would be incorrect. + This option accepts a string or &null;. + Available as of cURL 7.1.0. + + + Don't do this without making sure the server supports the custom + request method first. + + + + + + + + CURLOPT_DEFAULT_PROTOCOL + (int) + + + + A string with the default protocol to use if the URL is missing a scheme name. + Available as of PHP 7.0.7 and cURL 7.45.0. + + + + + + CURLOPT_DIRLISTONLY + (int) + + + + Setting this option to 1 will have different effects + based on the protocol it is used with. + FTP and SFTP based URLs will list only the names of files in a directory. + POP3 will list the email message or messages on the POP3 server. + For FILE, this option has no effect + as directories are always listed in this mode. + Using this option with CURLOPT_WILDCARDMATCH + will prevent the latter from having any effect. + Defaults to 0. + Available as of cURL 7.17.0. + + + + + + CURLOPT_DISALLOW_USERNAME_IN_URL + (int) + + + + &true; to not allow URLs that include a username. + Usernames are allowed by default. + Available as of PHP 7.3.0 and cURL 7.61.0. + + + + + + CURLOPT_DNS_CACHE_TIMEOUT + (int) + + + + The number of seconds to keep DNS entries in memory. This + option is set to 120 (2 minutes) by default. + This option accepts any value that can be cast to a valid int. + Available as of cURL 7.9.3. + + + + + + CURLOPT_DNS_INTERFACE + (int) + + + + Set the name of the network interface that the DNS resolver should bind to. + This must be an interface name (not an address). + This option accepts a string or &null;. + Available as of PHP 7.0.7 and cURL 7.33.0 + + + + + + CURLOPT_DNS_LOCAL_IP4 + (int) + + + + Set the local IPv4 address that the resolver should bind to. + The argument should contain a single numerical IPv4 address. + This option accepts a string or &null;. + Available as of PHP 7.0.7 and cURL 7.33.0. + + + + + + CURLOPT_DNS_LOCAL_IP6 + (int) + + + + Set the local IPv6 address that the resolver should bind to. + The argument should contain a single numerical IPv6 address. + This option accepts a string or &null;. + Available as of PHP 7.0.7 and cURL 7.33.0. + + + + + + CURLOPT_DNS_SERVERS + (int) + + + + Pass a string with a comma-separated list of DNS servers to be used + instead of the system default + (e.g.: 192.168.1.100,192.168.1.101:8080). + Available as of cURL 7.24.0. + + + + + + CURLOPT_DNS_SHUFFLE_ADDRESSES + (int) + + + + &true; to shuffle the order of all returned addresses so that they will be used + in a random order, when a name is resolved and more than one IP address is returned. + This may cause IPv4 to be used before IPv6 or vice versa. + Available as of PHP 7.3.0 and cURL 7.60.0. + + + + + + CURLOPT_DNS_USE_GLOBAL_CACHE + (int) + + + + &true; to use a global DNS cache. This option is not thread-safe. + It is conditionally enabled by default if PHP is built for non-threaded use + (CLI, FCGI, Apache2-Prefork, etc.). + Available as of cURL 7.9.3 and deprecated as of cURL 7.11.1. + As of PHP 8.4, this option no longer has any effect. + + + + + + CURLOPT_DOH_SSL_VERIFYHOST + (int) + + + + Set to 2 to verify the DNS-over-HTTPS server's SSL certificate name fields against the host name. + Available as of PHP 8.2.0 and cURL 7.76.0. + + + + + + CURLOPT_DOH_SSL_VERIFYPEER + (int) + + + + Set to 1 to enable and 0 to disable + verification of the authenticity of the DNS-over-HTTPS server's SSL certificate. + Available as of PHP 8.2.0 and cURL 7.76.0. + + + + + + CURLOPT_DOH_SSL_VERIFYSTATUS + (int) + + + + Set to 1 to enable and 0 to disable + the verification of the status of the DNS-over-HTTPS server certificate + using the "Certificate Status Request" TLS extension (OCSP stapling). + Available as of PHP 8.2.0 and cURL 7.76.0. + + + + + + CURLOPT_DOH_URL + (int) + + + + Provides the DNS-over-HTTPS URL. + This option accepts a string or &null;. + Available as of PHP 8.1.0 and cURL 7.62.0. + + + + + + CURLOPT_EGDSOCKET + (int) + + + + Like CURLOPT_RANDOM_FILE, except a filename + to an Entropy Gathering Daemon socket. + Available as of cURL 7.7.0 and deprecated as of cURL 7.84.0. + + + + + + CURLOPT_ENCODING + (int) + + + + The contents of the Accept-Encoding: header as a string. + This enables decoding of the response. Supported encodings are: + + identity + deflate + gzip + . + If an empty string is set, + a header containing all supported encoding types is sent. + Available as of cURL 7.10 and deprecated as of cURL 7.21.6. + + + + + + CURLOPT_EXPECT_100_TIMEOUT_MS + (int) + + + + The timeout for Expect: 100-continue responses in milliseconds. + Defaults to 1000 milliseconds. + This option accepts any value that can be cast to a valid int. + Available as of PHP 7.0.7 and cURL 7.36.0. + + + + + + CURLOPT_FAILONERROR + (int) + + + + &true; to fail verbosely if the HTTP code returned + is greater than or equal to 400. The default behavior is to return + the page normally, ignoring the code. + Available as of cURL 7.1.0. + + + + + + CURLOPT_FILE + (int) + + + + Accepts a file handle resource + to the file that the transfer should be written to. + The default is STDOUT (the browser window). + Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7. + + + + + + CURLOPT_FILETIME + (int) + + + + Set to &true; to attempt to retrieve the modification + date of the remote document. This value can be retrieved using + the CURLINFO_FILETIME option with + curl_getinfo. + Available as of cURL 7.5.0. + + + + + + CURLOPT_FNMATCH_FUNCTION + (int) + + + + Pass a callable that will be used for wildcard matching. + The signature of the callback should be: + + intcallback + resourcecurlHandle + stringpattern + stringstring + + + + curlHandle + + + The cURL handle. + + + + + pattern + + + The wildcard pattern. + + + + + string + + + The string to run the wildcard pattern matching on. + + + + + The callback should return + CURL_FNMATCHFUNC_MATCH if pattern matches the string, + CURL_FNMATCHFUNC_NOMATCH if not + or CURL_FNMATCHFUNC_FAIL if an error occurred. + Available as of cURL 7.21.0. + + + + + + CURLOPT_FOLLOWLOCATION + (int) + + + + Set to &true; to follow any Location: header that the server sends as + part of the HTTP header. + See also CURLOPT_MAXREDIRS. + This constant is not available when open_basedir + is enabled. + Available as of cURL 7.1.0. + + + + + + CURLOPT_FORBID_REUSE + (int) + + + + Set to &true; to force the connection to explicitly + close when it has finished processing, and not be pooled for reuse. + Available as of cURL 7.7.0. + + + + + + CURLOPT_FRESH_CONNECT + (int) + + + + Set to &true; to force the use of a new connection + instead of a cached one. + Available as of cURL 7.7.0. + + + + + + CURLOPT_FTPAPPEND + (int) + + + + Set to &true; to append to the remote file instead of + overwriting it. + Available as of cURL 7.1.0 and deprecated as of cURL 7.16.4. + + + + + + CURLOPT_FTPASCII + (int) + + + + An alias of + CURLOPT_TRANSFERTEXT. Use that instead. + Available as of cURL 7.1, deprecated as of cURL 7.11.1 + and last available in cURL 7.15.5. + Removed as of PHP 7.3.0. + + + + + + CURLOPT_FTPLISTONLY + (int) + + + + Set to &true; to only list the names of an FTP directory. + Available as of cURL 7.1.0 and deprecated as of cURL 7.16.4. + + + + + + CURLOPT_FTPPORT + (int) + + + + A string which will be used to get the IP address to use for the FTP PORT instruction. The PORT instruction tells + the remote server to connect to our specified IP address. The + string may be a plain IP address, a hostname, + a network interface name (under Unix), + or just a plain - to use the system's default IP address. + This option accepts a string or &null;. + Available as of cURL 7.1.0. + + + + + + CURLOPT_FTPSSLAUTH + (int) + + + + Set the FTP over SSL authentication method (if activated) to any of the + CURLFTPAUTH_* constants. + Defaults to CURLFTPAUTH_DEFAULT. + Available as of cURL 7.12.2. + + + + + + CURLOPT_FTP_ACCOUNT + (int) + + + + Pass a string that will be sent as account information over FTP + (using the ACCT command) after username and password has been provided + to the server. + Set to &null; to disable sending the account information. + Defaults to &null;. + Available as of cURL 7.13.0. + + + + + + CURLOPT_FTP_ALTERNATIVE_TO_USER + (int) + + + + Pass a string that will be used to try to authenticate over FTP + if the USER/PASS negotiation fails. + Available as of cURL 7.15.5. + + + + + + CURLOPT_FTP_CREATE_MISSING_DIRS + (int) + + + + Set to &true; to create missing directories when an FTP operation + encounters a path that currently doesn't exist. + Available as of cURL 7.10.7. + + + + + + CURLOPT_FTP_FILEMETHOD + (int) + + + + Tell cURL which method to use to reach a file on a FTP(S) server. Possible values are + any of the CURLFTPMETHOD_* constants. + Defaults to CURLFTPMETHOD_MULTICWD. + Available as of cURL 7.15.1. + + + + + + CURLOPT_FTP_RESPONSE_TIMEOUT + (int) + + + + A timeout in seconds cURL will wait for a response from an FTP server. + This option overrides CURLOPT_TIMEOUT. + This option accepts any value that can be cast to a valid int. + This option name is replaced with CURLOPT_SERVER_RESPONSE_TIMEOUT, + available as of 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) + + + + If this option is set to 1 + cURL will not use the IP address the server suggests + in its 227-response to cURL's PASV command + but will use the IP address it used for the connection. + The port number received from the 227-response will not be ignored by cURL. + Defaults to 1 as of cURL 7.74.0 + and 0 prior to that. + 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) + + + + This option makes cURL use CCC (Clear Command Channel) + which shuts down the SSL/TLS layer after authenticating + making the rest of the control channel communication unencrypted. + Use one of the CURLFTPSSL_CCC_* constants. + Defaults to CURLFTPSSL_CCC_NONE. + Available as of cURL 7.16.1. + + + + + + CURLOPT_FTP_USE_EPRT + (int) + + + + Set to &true; to use EPRT (and LPRT) when doing active FTP downloads. + Set to &false; to disable EPRT and LPRT and use PORT only. + Available as of cURL 7.10.5. + + + + + + CURLOPT_FTP_USE_EPSV + (int) + + + + Set to &true; to first try an EPSV command for FTP transfers before reverting back to PASV. + Set to &false; to disable EPSV. + Available as of cURL 7.9.2. + + + + + + CURLOPT_FTP_USE_PRET + (int) + + + + Set to 1 to send a PRET command + before PASV (and EPSV). + Has no effect when using the active FTP transfers mode. + Defaults to 0. + Available as of cURL 7.20.0. + + + + + + CURLOPT_GSSAPI_DELEGATION + (int) + + + + Set to CURLGSSAPI_DELEGATION_FLAG + to allow unconditional GSSAPI credential delegation. + Set to CURLGSSAPI_DELEGATION_POLICY_FLAG + to delegate only if the OK-AS-DELEGATE flag is set + in the service ticket. + Defaults to CURLGSSAPI_DELEGATION_NONE. + Available as of cURL 7.22.0. + + + + + + CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS + (int) + + + + Head start for IPv6 for the happy eyeballs algorithm. Happy eyeballs attempts + to connect to both IPv4 and IPv6 addresses for dual-stack hosts, + preferring IPv6 first for timeout milliseconds. + Defaults to CURL_HET_DEFAULT, which is currently 200 milliseconds. + This option accepts any value that can be cast to a valid int. + Available as of PHP 7.3.0 and cURL 7.59.0 + + + + + + CURLOPT_HAPROXYPROTOCOL + (int) + + + + &true; to send an HAProxy PROXY protocol v1 header at the start of the connection. + The default action is not to send this header. + Available as of PHP 7.3.0 and cURL 7.60.0. + + + + + + CURLOPT_HEADER + (int) + + + + Set to &true; to include the headers in the output sent to the callback + defined by CURLOPT_WRITEFUNCTION. + Available as of cURL 7.1.0. + + + + + + CURLOPT_HEADERFUNCTION + (int) + + + + A callable with the following signature: + + intcallback + resourcecurlHandle + stringheaderData + + + + curlHandle + + + The cURL handle. + + + + + headerData + + + The header data which must be written by the callback. + + + + + The callback should return the number of bytes written. + Available as of cURL 7.7.2. + + + + + + CURLOPT_HEADEROPT + (int) + + + + Send HTTP headers to both proxy and host or separately. + Possible values are any of the + CURLHEADER_* constants. + Defaults to CURLHEADER_SEPARATE as of cURL + 7.42.1, and CURLHEADER_UNIFIED prior to that. + Available as of PHP 7.0.7 and cURL 7.37.0. + + + + + + CURLOPT_HSTS + (int) + + + + string with HSTS (HTTP Strict Transport Security) cache file name + or &null; to allow HSTS without reading from or writing to any file + and clear the list of files to read HSTS data from. + Available as of PHP 8.2.0 and cURL 7.74.0. + + + + + + CURLOPT_HSTS_CTRL + (int) + + + + Accepts a bitmask of HSTS (HTTP Strict Transport Security) features + defined by the CURLHSTS_* constants. + Available as of PHP 8.2.0 and cURL 7.74.0. + + + + + + CURLOPT_HTTP09_ALLOWED + (int) + + + + Whether to allow HTTP/0.9 responses. Defaults to &false; as of cURL 7.66.0; + formerly it defaulted to &true;. + Available as of PHP 7.3.15 and 7.4.3, respectively, and cURL 7.64.0. + + + + + + CURLOPT_HTTP200ALIASES + (int) + + + + An array of HTTP 200 responses that will be treated as valid responses and not as errors. + Available as of cURL 7.10.3. + + + + + + CURLOPT_HTTPAUTH + (int) + + + + A bitmask of HTTP authentication method(s) to use. The options are: + + CURLAUTH_BASIC + CURLAUTH_DIGEST + CURLAUTH_GSSNEGOTIATE + CURLAUTH_NTLM + CURLAUTH_AWS_SIGV4 + CURLAUTH_ANY + CURLAUTH_ANYSAFE + . + If more than one method is used, cURL will poll the server to see + what methods it supports and pick the best one. + CURLAUTH_ANY sets all bits. cURL will automatically select + the one it finds most secure. + CURLAUTH_ANYSAFE sets all bits except CURLAUTH_BASIC. + cURL will automatically select the one it finds most secure. + Available as of cURL 7.10.6. + + + + + + CURLOPT_HTTPGET + (int) + + + + Set to &true; to reset the HTTP request method to GET. Since GET is the default, this is only necessary if the request + method has been changed. + Available as of cURL 7.8.1. + + + + + + CURLOPT_HTTPHEADER + (int) + + + + An array of HTTP header fields to set, in the format + + array('Content-type: text/plain', 'Content-length: 100') + + Available as of cURL 7.1.0. + + + + + + CURLOPT_HTTPPROXYTUNNEL + (int) + + + + &true; to tunnel through a given HTTP proxy. + Available as of cURL 7.3.0. + + + + + + CURLOPT_HTTP_CONTENT_DECODING + (int) + + + + &false; to get the raw HTTP response body. + Available as of cURL 7.16.2. + + + + + + CURLOPT_HTTP_TRANSFER_DECODING + (int) + + + + If set to 0, transfer decoding is disabled. + If set to 1, transfer decoding is enabled. + cURL does chunked transfer decoding by default + unless this option is set to 0. + Defaults to 1. + Available as of cURL 7.16.2. + + + + + + CURLOPT_HTTP_VERSION + (int) + + + + Set to one of the + CURL_HTTP_VERSION_* constants + for cURL to use the specified HTTP version. + Available as of cURL 7.9.1. + + + + + + CURLOPT_IGNORE_CONTENT_LENGTH + (int) + + + + If set to 1, + ignore the Content-Length header in the HTTP response + and ignore asking for or relying on it for FTP transfers. + Defaults to 0. + Available as of cURL 7.14.1. + + + + + + CURLOPT_INFILE + (int) + + + + Accepts a file handle resource + to the file that the transfer should be read from when uploading. + Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7. + Use CURLOPT_READDATA instead. + + + + + + CURLOPT_INFILESIZE + (int) + + + + The expected size, in bytes, of the file when uploading a file to + a remote site. Note that using this option will not stop cURL + from sending more data, as exactly what is sent depends on + CURLOPT_READFUNCTION. + This option accepts any value that can be cast to a valid int. + Available as of cURL 7.1.0. + + + + + + CURLOPT_INTERFACE + (int) + + + + Set to a string with the name of the outgoing network interface to use. + This can be an interface name, an IP address or a host name. + Available as of cURL 7.1.0. + + + + + + CURLOPT_IPRESOLVE + (int) + + + + Allows an application to select what kind of IP addresses to use when + resolving host names. This is only interesting when using host names that + resolve addresses using more than one version of IP. + Set to one of the + CURL_IPRESOLVE_* constants. + Defaults to CURL_IPRESOLVE_WHATEVER. + Available as of cURL 7.10.8. + + + + + + CURLOPT_ISSUERCERT + (int) + + + + If set to a string naming a file holding a CA certificate in PEM format, + an additional check against the peer certificate is performed + to verify the issuer is indeed the one associated + with the certificate provided by the option. + For the result of the check to be considered a failure, + this option should be used in combination with the + CURLOPT_SSL_VERIFYPEER option. + Available as of cURL 7.19.0. + + + + + + CURLOPT_ISSUERCERT_BLOB + (int) + + + + Pass a string with binary data of a CA SSL certificate in PEM format. + If set, an additional check against the peer certificate is performed + to verify the issuer is the one associated with the certificate provided by the option. + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_KEEP_SENDING_ON_ERROR + (int) + + + + Set to &true; to keep sending the request body if the HTTP code returned is equal to or larger than 300. + The default action would be to stop sending + and close the stream or connection. Suitable for manual NTLM authentication. + Most applications do not need this option. + Available as of PHP 7.3.0 and cURL 7.51.0. + + + + + + CURLOPT_KEYPASSWD + (int) + + + + Set to a string with the password required to use the CURLOPT_SSLKEY + or CURLOPT_SSH_PRIVATE_KEYFILE private key. + Setting this option to &null; disables using a password for these options. + Available as of cURL 7.17.0. + + + + + + CURLOPT_KRB4LEVEL + (int) + + + + The KRB4 (Kerberos 4) security level. Any of the following string values + (in order from least to most powerful) are valid: + + clear + safe + confidential + private + . + If the string does not match one of these, + private is used. Setting this option to &null; + will disable KRB4 security. Currently KRB4 security only works + with FTP transactions. + Available as of cURL 7.3.0 and deprecated as of cURL 7.17.0. + + + + + + CURLOPT_KRBLEVEL + (int) + + + + Set the kerberos security level for FTP and also enables kerberos awareness. + This should be set to one of the following strings: + + clear + safe + confidential + private + . + If the string is set but does not match one of these, + private is used. + Setting this option to &null; will disable kerberos support for FTP. + Defaults to &null;. + Available as of cURL 7.16.4. + + + + + + CURLOPT_LOCALPORT + (int) + + + + Sets the local port number of the socket used for the connection. + This option accepts any value that can be cast to a valid int. + Defaults to 0. + Available as of cURL 7.15.2. + + + + + + CURLOPT_LOCALPORTRANGE + (int) + + + + The number of attempts cURL makes to find a working local port number, + starting with the one set with CURLOPT_LOCALPORT. + This option accepts any value that can be cast to a valid int. + Defaults to 1. + Available as of cURL 7.15.2. + + + + + + CURLOPT_LOGIN_OPTIONS + (int) + + + + Can be used to set protocol specific login options, such as the + preferred authentication mechanism via AUTH=NTLM or AUTH=*, and should be used in conjunction with the + CURLOPT_USERNAME option. + Available as of PHP 7.0.7 and cURL 7.34.0. + + + + + + CURLOPT_LOW_SPEED_LIMIT + (int) + + + + The transfer speed, in bytes per second, that the transfer should be + below during the count of CURLOPT_LOW_SPEED_TIME + seconds before PHP considers the transfer too slow and aborts. + This option accepts any value that can be cast to a valid int. + Available as of cURL 7.1.0. + + + + + + CURLOPT_LOW_SPEED_TIME + (int) + + + + The number of seconds the transfer speed should be below + CURLOPT_LOW_SPEED_LIMIT before PHP considers + the transfer too slow and aborts. + This option accepts any value that can be cast to a valid int. + Available as of cURL 7.1.0. + + + + + + CURLOPT_MAIL_AUTH + (int) + + + + Set a string with the authentication address (identity) + of a submitted message that is being relayed to another server. + The address should not be specified within a pair of angled brackets + (><). + If an empty string is used then a pair of brackets are sent by cURL + as required by RFC 2554. + Available as of cURL 7.25.0. + + + + + + CURLOPT_MAIL_FROM + (int) + + + + Set a string with the sender's email address when sending SMTP mail. + The email address should be specified with angled brackets + (><) around it, + which if not specified are added automatically. + If this parameter is not specified then an empty address is sent + to the SMTP server which might cause the email to be rejected. + Available as of cURL 7.20.0. + + + + + + CURLOPT_MAIL_RCPT + (int) + + + + Set to an array of strings + with the recipients to pass to the server in an SMTP mail request. + Each recipient should be specified within a pair of angled brackets + (><). + If an angled bracket is not used as the first character, + cURL assumes a single email address has been provided + and encloses that address within brackets. + Available as of cURL 7.20.0. + + + + + + CURLOPT_MAIL_RCPT_ALLLOWFAILS + (int) + + + + Set to 1 to allow RCPT TO command + to fail for some recipients which makes cURL ignore errors + for individual recipients and proceed with the remaining accepted recipients. + If all recipients trigger failures and this flag is specified, + cURL aborts the SMTP conversation + and returns the error received from to the last RCPT TO command. + Replaced by CURLOPT_MAIL_RCPT_ALLOWFAILS as of cURL 8.2.0. + Available as of PHP 8.2.0 and cURL 7.69.0. + Deprecated as of cURL 8.2.0. + + + + + + CURLOPT_MAXAGE_CONN + (int) + + + + The maximum idle time allowed for an existing connection to be considered for reuse. + Default maximum age is set to 118 seconds. + This option accepts any value that can be cast to a valid int. + Available as of PHP 8.2.0 and cURL 7.65.0. + + + + + + CURLOPT_MAXCONNECTS + (int) + + + + The maximum amount of persistent connections that are allowed. + When the limit is reached, the oldest one in the cache is closed + to prevent increasing the number of open connections. + This option accepts any value that can be cast to a valid int. + Available as of cURL 7.7.0. + + + + + + CURLOPT_MAXFILESIZE + (int) + + + + Sets the maximum accepted size (in bytes) of a file to download. + If the file requested is found larger than this value, + the transfer is aborted + and CURLE_FILESIZE_EXCEEDED is returned. + Passing 0 disables this option, + and passing a negative size returns a + CURLE_BAD_FUNCTION_ARGUMENT. + If the file size is not known prior to the start of download, + this option has no effect. + For setting a size limit above 2GB, + CURLOPT_MAXFILESIZE_LARGE should be used. + As of cURL 8.4.0, this option also stops ongoing transfers + if they reach this threshold. + This option accepts any value that can be cast to a valid int. + Defaults to 0. + Available as of cURL 7.10.8. + + + + + + CURLOPT_MAXFILESIZE_LARGE + (int) + + + + The maximum file size in bytes allowed to download. If the file requested is found larger than this value, + the transfer will not start and CURLE_FILESIZE_EXCEEDED will be returned. + The file size is not always known prior to download, and for such files this option has no effect even if + the file transfer ends up being larger than this given limit. + This option accepts any value that can be cast to a valid int. + Available as of PHP 8.2.0 and cURL 7.11.0. + + + + + + CURLOPT_MAXLIFETIME_CONN + (int) + + + + The maximum time in seconds, since the creation of the connection, that is allowed for an existing + connection to have for it to be considered for reuse. If a connection is found in the cache that is older + than this value, it will instead be closed once any in-progress transfers are complete. + Default is 0 seconds, meaning the option is disabled and all connections are eligible for reuse. + This option accepts any value that can be cast to a valid int. + Available as of PHP 8.2.0 and cURL 7.80.0. + + + + + + CURLOPT_MAXREDIRS + (int) + + + + The maximum amount of HTTP redirections to follow. Use this option alongside CURLOPT_FOLLOWLOCATION. + Default value of 20 is set to prevent infinite redirects. + Setting to -1 allows inifinite redirects, and 0 refuses all redirects. + Available as of cURL 7.5.0. + + + + + + CURLOPT_MAX_RECV_SPEED_LARGE + (int) + + + + If a download exceeds this speed (counted in bytes per second) on + cumulative average during the transfer, the transfer will pause to + keep the average rate less than or equal to the parameter value. + Defaults to unlimited speed. + This option accepts any value that can be cast to a valid int. + Available as of cURL 7.15.5. + + + + + + CURLOPT_MAX_SEND_SPEED_LARGE + (int) + + + + If an upload exceeds this speed (counted in bytes per second) on + cumulative average during the transfer, the transfer will pause to + keep the average rate less than or equal to the parameter value. + Defaults to unlimited speed. + This option accepts any value that can be cast to a valid int. + Available as of cURL 7.15.5. + + + + + + CURLOPT_MIME_OPTIONS + (int) + + + + Set to a bitmask of CURLMIMEOPT_* + constants. Currently there is only one available option: + CURLMIMEOPT_FORMESCAPE. + Available as of PHP 8.3.0 and cURL 7.81.0. + + + + + + CURLOPT_MUTE + (int) + + + + Set to &true; to be completely silent with regards to + the cURL functions. + Use CURLOPT_RETURNTRANSFER instead. + 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) + + + + Set to &true; to scan the ~/.netrc + file to find a username and password for the remote site that + a connection is being established with. + Available as of cURL 7.1.0. + + + + + + CURLOPT_NETRC_FILE + (int) + + + + Set a string containing the full path name to a .netrc file. + If this option is omitted and CURLOPT_NETRC is set, + cURL checks for a .netrc file + in the current user's home directory. + Available as of cURL 7.11.0. + + + + + + CURLOPT_NEW_DIRECTORY_PERMS + (int) + + + + Sets the value of the permissions (int) that is set on newly created directories + on the remote server. The default value is 0755. + The only protocols that can use this are + sftp://, scp:// + and file://. + Available as of cURL 7.16.4. + + + + + + CURLOPT_NEW_FILE_PERMS + (int) + + + + Sets the value of the permissions (as an int) that are set on newly created files + on the remote server. The default value is 0644. + The only protocols that can use this are + sftp://, scp:// + and file://. + Available as of cURL 7.16.4. + + + + + + CURLOPT_NOBODY + (int) + + + + Set to &true; to exclude the body from the output. + For HTTP(S), cURL makes a HEAD request. For most other protocols, + cURL is not asking for the body data at all. + Changing this to &false; will result in body data being included in the output. + Available as of cURL 7.1.0. + + + + + + CURLOPT_NOPROGRESS + (int) + + + + Set to &true; to disable the progress meter for cURL transfers. + + + PHP automatically sets this option to &true;, this should only be + changed for debugging purposes. + + + Available as of cURL 7.1.0. + + + + + + CURLOPT_NOPROXY + (int) + + + + Set a string consisting of a comma separated list of hostnames + that do not require a proxy to get reached. + Each name in this list is matched as either a domain + which contains the hostname or the hostname itself. + The only wildcard available in the string + is a single * character which matches all hosts, + effectively disabling the proxy. + Setting this option to an empty string enables the proxy for all hostnames. + Since cURL 7.86.0, IP addresses set with this option + can be provided using CIDR notation. + Available as of cURL 7.19.4. + + + + + + CURLOPT_NOSIGNAL + (int) + + + + &true; to ignore any cURL function that causes a + signal to be sent to the PHP process. This is turned on by default + in multi-threaded SAPIs so timeout options can still be used. + Available as of cURL 7.10. + + + + + + CURLOPT_PASSWDFUNCTION + (int) + + + + A callable with the following signature: + + stringcallback + resourcecurlHandle + stringpasswordPrompt + intmaximumPasswordLength + + + + curlHandle + + + The cURL handle. + + + + + passwordPrompt + + + A password prompt. + + + + + maximumPasswordLength + + + The maximum length of the password. + + + + + The callback should return a string containing the password. + 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) + + + + Set to a string with the password to use in authentication. + Available as of cURL 7.19.1. + + + + + + CURLOPT_PATH_AS_IS + (int) + + + + Set to &true; for cURL not alter URL paths before passing them on to the server. + Defaults to &false;, which squashes sequences of /../ + or /./ that may exist in the URL's path part + which is supposed to be removed according to RFC 3986 section 5.2.4. + Available as of PHP 7.0.7 and cURL 7.42.0. + + + + + + CURLOPT_PINNEDPUBLICKEY + (int) + + + + Set a string with the pinned public key. + The string can be the file name of the pinned public key + in a PEM or DER file format. The string can also be any + number of base64 encoded sha256 hashes preceded by sha256// and + separated by ;. + Available as of PHP 7.0.7 and cURL 7.39.0. + + + + + + CURLOPT_PIPEWAIT + (int) + + + + Set to &true; to wait for an existing connection to confirm + whether it can do multiplexing and use it if it can + before creating and using a new connection. + Available as of PHP 7.0.7 and cURL 7.43.0. + + + + + + CURLOPT_PORT + (int) + + + + An int with an alternative port number to connect to + instead of the one specified in the URL or the default port for the used protocol. + Available as of cURL 7.1.0. + + + + + + CURLOPT_POST + (int) + + + + Set to &true; to do a HTTP POST request. + This request uses the application/x-www-form-urlencoded header. + Defaults to &false;. + Available as of cURL 7.1.0. + + + + + + CURLOPT_POSTFIELDS + (int) + + + + The full data to post in a HTTP POST operation. + This parameter can either be + passed as a urlencoded string like 'para1=val1&para2=val2&...' + or as an array with the field name as key and field data as value. + If value is an array, the + Content-Type header will be set to + multipart/form-data. + Files can be sent using CURLFile or CURLStringFile, + in which case value must be an array. + Available as of cURL 7.1.0. + + + + + + CURLOPT_POSTQUOTE + (int) + + + + An array of FTP command strings + to execute on the server after the FTP request has been performed. + Available as of cURL 7.1.0. + + + + + + CURLOPT_POSTREDIR + (int) + + + + Set to a bitmask of CURL_REDIR_POST_301, + CURL_REDIR_POST_302 and CURL_REDIR_POST_303 + if the HTTP POST method should be maintained + when CURLOPT_FOLLOWLOCATION is set and a + specific type of redirect occurs. + Available as of cURL 7.19.1. + + + + + + CURLOPT_PRE_PROXY + (int) + + + + Set a string 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 + CURLOPT_PROXY option for the upcoming request. + The preproxy can only be a SOCKS proxy and it should be prefixed with + [scheme]:// 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 :[port] + to the end of the host name. The proxy's port number may optionally be + specified with the separate option CURLOPT_PROXYPORT. + Defaults to using port 1080 for proxies if a port is not specified. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PREQUOTE + (int) + + + + Set an array of FTP command strings to pass to the server + after the transfer type is set. + These commands are not performed when a directory listing is performed, + only for file transfers. + Available as of cURL 7.9.5. + + + + + + CURLOPT_PRIVATE + (int) + + + + Any data that should be associated with this cURL handle. This data + can subsequently be retrieved with the + CURLINFO_PRIVATE option of + curl_getinfo. cURL does nothing with this data. + When using a cURL multi handle, this private data is typically a + unique key to identify a standard cURL handle. + Available as of cURL 7.10.3. + + + + + + CURLOPT_PROGRESSFUNCTION + (int) + + + + A callable with the following signature: + + intcallback + resourcecurlHandle + intbytesToDownload + intbytesDownloaded + intbytesToUpload + intbytesUploaded + + + + curlHandle + + + The cURL handle. + + + + + bytesToDownload + + + The total number of bytes expected to be downloaded in this transfer. + + + + + bytesDownloaded + + + The number of bytes downloaded so far. + + + + + bytesToUpload + + + The total number of bytes expected to be uploaded in this transfer. + + + + + bytesUploaded + + + The number of bytes uploaded so far. + + + + + The callback should return an int with a non-zero value to abort the transfer + and set a CURLE_ABORTED_BY_CALLBACK error. + + + The callback is only called when the CURLOPT_NOPROGRESS + option is set to &false;. + + + Available as of cURL 7.1.0 and deprecated as of cURL 7.32.0. + Use CURLOPT_XFERINFOFUNCTION instead. + + + + + + CURLOPT_PROTOCOLS + (int) + + + + Bitmask of CURLPROTO_* values. + If used, this bitmask limits what protocols cURL may use in the transfer. + Defaults to CURLPROTO_ALL, ie. cURL will accept all protocols it supports. + See also CURLOPT_REDIR_PROTOCOLS. + Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0. + + + + + + CURLOPT_PROTOCOLS_STR + (int) + + + + Set to a string with a comma separated list + of case insensitive protocol names (URL schemes) to allow in the transfer. + Set to ALL to enable all protocols. + By default, cURL accepts all protocols it was built with support for. + Available protocols are: + + 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) + + + + A string with the HTTP proxy to tunnel requests through. + This should be the hostname, the dotted numerical IP address + or a numerical IPv6 address written within [brackets]. + Available as of cURL 7.1.0. + + + + + + CURLOPT_PROXYAUTH + (int) + + + + A bitmask of the HTTP authentication method(s) + (CURLAUTH_* constants) + to use for the proxy connection. + For proxy authentication, only CURLAUTH_BASIC and + CURLAUTH_NTLM are currently supported. + Defaults to CURLAUTH_BASIC. + Available as of cURL 7.10.7. + + + + + + CURLOPT_PROXYHEADER + (int) + + + + An array of custom HTTP header strings to pass to proxies. + Available as of PHP 7.0.7 and cURL 7.37.0. + + + + + + CURLOPT_PROXYPASSWORD + (int) + + + + Set a string with the password to be used for authentication with the proxy. + Available as of cURL 7.19.1. + + + + + + CURLOPT_PROXYPORT + (int) + + + + An int with the port number of the proxy to connect to. + This port number can also be set in CURLOPT_PROXY. + Setting this to zero makes cURL use the default proxy port number + or the port number specified in the proxy URL string. + Available as of cURL 7.1.0. + + + + + + CURLOPT_PROXYTYPE + (int) + + + + Sets the type of the proxy to one of the + CURLPROXY_* constants. + Defaults to CURLPROXY_HTTP. + Available as of cURL 7.10. + + + + + + CURLOPT_PROXYUSERNAME + (int) + + + + Set a string with the username to be used for authentication with the proxy. + Available as of cURL 7.19.1. + + + + + + CURLOPT_PROXYUSERPWD + (int) + + + + A string with a username and password formatted as + [username]:[password] to use for the + connection to the proxy. + Available as of cURL 7.1.0. + + + + + + CURLOPT_PROXY_CAINFO + (int) + + + + The path to proxy Certificate Authority (CA) bundle. Set the path as a + string 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 cURL's cacert bundle is assumed + to be stored. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_CAINFO_BLOB + (int) + + + + A string with the name of a PEM 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 cURL's cacert bundle is assumed + to be stored. + Available as of PHP 8.2.0 and cURL 7.77.0. + + + + + + CURLOPT_PROXY_CAPATH + (int) + + + + A string with the directory holding multiple CA certificates + to verify the HTTPS proxy with. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_CRLFILE + (int) + + + + Set to a string with 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. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_ISSUERCERT + (int) + + + + Proxy issuer SSL certificate filename string. + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_PROXY_ISSUERCERT_BLOB + (int) + + + + A string with the proxy issuer SSL certificate. + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_PROXY_KEYPASSWD + (int) + + + + Set the string be used as the password required to use the + CURLOPT_PROXY_SSLKEY private key. + A passphrase is not needed to load a certificate + but one is needed to load a private key. + This option is for connecting to an HTTPS proxy, not an HTTPS server. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_PINNEDPUBLICKEY + (int) + + + + Set the pinned public key for HTTPS proxy. + The string can be the file name of the pinned public key + which is expected to be in a PEM + or DER file format. + The string can also be any number of base64 encoded sha256 hashes + preceded by sha256// and separated by ;. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SERVICE_NAME + (int) + + + + A string with the proxy authentication service name. + 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) + + + + A string with the file name of the 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 CURLOPT_PROXY_SSLCERTTYPE. + With NSS or Secure Transport, this can also be the nickname of the certificate + used for authentication as it is named in the security database. + If a file from the current directory is to be used, + it must be prefixed with ./ + in order to avoid confusion with a nickname. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSLCERTTYPE + (int) + + + + A string with the format of the 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. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSLCERT_BLOB + (int) + + + + A string with the SSL proxy client certificate. + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_PROXY_SSLKEY + (int) + + + + A string with the file name of the private key + used for connecting to the HTTPS proxy. + The default format is PEM and can be changed with + CURLOPT_PROXY_SSLKEYTYPE. + (iOS and Mac OS X only) This option is ignored if cURL was built against + Secure Transport. Available if built with TLS enabled. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSLKEYTYPE + (int) + + + + A string with the format of the private key. + Supported formats are: + + PEM + DER + ENG + . + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSLKEY_BLOB + (int) + + + + A string with the private key for connecting to the HTTPS proxy. + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_PROXY_SSLVERSION + (int) + + + + Set the preferred HTTPS proxy TLS version to one of the + CURL_SSLVERSION_* + constants. + Defaults to CURL_SSLVERSION_DEFAULT. + + + It is better to not set this option and leave the default + CURL_SSLVERSION_DEFAULT + which will attempt to figure out the remote SSL protocol version. + + + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSL_CIPHER_LIST + (int) + + + + A string with a colon-separated list of ciphers + to use for the connection to the HTTPS proxy. + When used with OpenSSL commas and spaces are also acceptable as separators, + and !, - and + + can be used as operators. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSL_OPTIONS + (int) + + + + Set proxy SSL behavior options, which is a bitmask of the + CURLSSLOPT_* constants. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSL_VERIFYHOST + (int) + + + + Set to 2 to verify in the HTTPS proxy's certificate name fields against the proxy name. + When set to 0 the connection succeeds regardless of the names used in the certificate. + Use that ability with caution! + Set to 1 in cURL 7.28.0 and earlier as a debug option. + Set to 1 in cURL 7.28.1 to 7.65.3 CURLE_BAD_FUNCTION_ARGUMENT is returned. + As of cURL 7.66.0 1 and 2 is treated as the same value. + Defaults to 2. + In production environments the value of this option should be kept at 2. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_SSL_VERIFYPEER + (int) + + + + Set to &false; to stop cURL from verifying the peer's certificate. + Alternate certificates to verify against can be + specified with the CURLOPT_CAINFO option + or a certificate directory can be specified with the + CURLOPT_CAPATH option. + When set to &false;, the peer certificate verification succeeds regardless. + &true; by default. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_TLS13_CIPHERS + (int) + + + + A string with a colon-separated list of ciphers to use for the connection to the TLS 1.3 connection to a proxy. + This option is currently used only when cURL is built to use OpenSSL 1.1.1 or later. + When using a different SSL backend the TLS 1.3 cipher suites can be set + with the CURLOPT_PROXY_SSL_CIPHER_LIST option. + Available as of PHP 7.3.0 and cURL 7.61.0. + + + + + + CURLOPT_PROXY_TLSAUTH_PASSWORD + (int) + + + + A string with the password to use for the TLS authentication method specified with the + CURLOPT_PROXY_TLSAUTH_TYPE option. Requires that the + CURLOPT_PROXY_TLSAUTH_USERNAME option to also be set. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_TLSAUTH_TYPE + (int) + + + + The method of the TLS authentication used for the HTTPS connection. + Supported method is SRP. + + + Secure Remote Password (SRP) authentication for TLS provides mutual authentication + if both sides have a shared secret. To use TLS-SRP, the + CURLOPT_PROXY_TLSAUTH_USERNAME and + CURLOPT_PROXY_TLSAUTH_PASSWORD options must also be set. + + + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_TLSAUTH_USERNAME + (int) + + + + The username to use for the HTTPS proxy TLS authentication method specified with the + CURLOPT_PROXY_TLSAUTH_TYPE option. Requires that the + CURLOPT_PROXY_TLSAUTH_PASSWORD option to also be set. + Available as of PHP 7.3.0 and cURL 7.52.0. + + + + + + CURLOPT_PROXY_TRANSFER_MODE + (int) + + + + Set to 1 to set the transfer mode (binary or ASCII) + for FTP transfers done via an HTTP proxy, by appending + type=a or type=i to the URL. + Without this setting or it being set to 0, + CURLOPT_TRANSFERTEXT has no effect + when doing FTP via a proxy. + Defaults to 0. + Available as of cURL 7.18.0. + + + + + + CURLOPT_PUT + (int) + + + + &true; to HTTP PUT a file. The file to PUT must + be set with CURLOPT_READDATA and + CURLOPT_INFILESIZE. + Available as of cURL 7.1.0 and deprecated as of cURL 7.12.1. + + + + + + CURLOPT_QUICK_EXIT + (int) + + + + Set to &true; for cURL to skip cleanup of resources + when recovering from a timeout. + This allows for a swift termination of the cURL process + at the expense of a possible leak of associated resources. + Available as of PHP 8.3.0 and cURL 7.87.0. + + + + + + CURLOPT_QUOTE + (int) + + + + An array of FTP command strings to execute on the server prior to the FTP request. + Available as of cURL 7.1.0. + + + + + + CURLOPT_RANDOM_FILE + (int) + + + + A string with a filename to be used to seed the random number generator for SSL. + Available as of cURL 7.7.0 and deprecated as of cURL 7.84.0. + + + + + + CURLOPT_RANGE + (int) + + + + A string with the range(s) of data to retrieve in the format X-Y where X or Y are optional. HTTP transfers + also support several intervals, separated with commas in the format + X-Y,N-M. + Set to &null; to disable requesting a byte range. + Available as of cURL 7.1.0. + + + + + + CURLOPT_READDATA + (int) + + + + Sets a file pointer resource that will be used by the file read function + set with CURLOPT_READFUNCTION. + Available as of cURL 7.9.7. + + + + + + CURLOPT_READFUNCTION + (int) + + + + A callable with the following signature: + + stringcallback + resourcecurlHandle + resourcestreamResource + intmaxAmountOfDataToRead + + + + curlHandle + + + The cURL handle. + + + + + streamResource + + + Stream resource provided to cURL through the option + CURLOPT_READDATA. + + + + + maxAmountOfDataToRead + + + The maximum amount of data to be read. + + + + + The callback should return a string + with a length equal or smaller than the amount of data requested, + typically by reading it from the passed stream resource. It should + return an empty string to signal EOF. + Available as of cURL 7.1.0. + + + + + + CURLOPT_REDIR_PROTOCOLS + (int) + + + + Bitmask of CURLPROTO_* values + which limit what protocols cURL may use in a transfer that it follows to in + a redirect when CURLOPT_FOLLOWLOCATION is enabled. + This allows limiting specific transfers to only be allowed to use a subset + of protocols in redirections. + As of cURL 7.19.4, by default cURL will allow all protocols + except for FILE and SCP. + Prior to cURL 7.19.4, cURL would unconditionally follow to all supported protocols. + See also CURLOPT_PROTOCOLS for protocol constant values. + Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0. + + + + + + CURLOPT_REDIR_PROTOCOLS_STR + (int) + + + + Set to a string with a comma separated list + of case insensitive protocol names (URL schemes) + to allow to follow to in a redirect when + CURLOPT_FOLLOWLOCATION is enabled. + Set to ALL to enable all protocols. + As of cURL 7.65.2 it defaults to FTP, + FTPS, HTTP and HTTPS. + From cURL 7.40.0 to 7.65.1, this defaults to all protocols except + FILE, SCP, SMB and + SMBS. + Prior to cURL 7.40.0, this defaults to all protocols except + FILE and SCP. + Available protocols are: + + 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) + + + + A string with the contents of the Referer: + header to be used in a HTTP request. + Available as of cURL 7.1.0. + + + + + + CURLOPT_REQUEST_TARGET + (int) + + + + A string to use in the upcoming request + instead of the path as extracted from the URL. + Available as of PHP 7.3.0 and cURL 7.55.0. + + + + + + CURLOPT_RESOLVE + (int) + + + + Provide an array of colon-separated strings + with custom addresses for specific host and port pairs in the following format: + + 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) + + + + The offset, in bytes, to resume a transfer from. + This option accepts any value that can be cast to a valid int. + Available as of cURL 7.1.0. + + + + + + CURLOPT_RETURNTRANSFER + (int) + + + + &true; to return the transfer as a string of the + return value of curl_exec instead of outputting + it directly. + + + + + + CURLOPT_RTSP_CLIENT_CSEQ + (int) + + + + Set an int with the CSEQ number to issue for the next RTSP request. + Useful if the application is resuming a previously broken connection. + The CSEQ increments from this new number henceforth. + Defaults to 0. + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_REQUEST + (int) + + + + Sets the kind of RTSP request to make. + Must be one of the CURL_RTSPREQ_* + constants. + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_SERVER_CSEQ + (int) + + + + Set an int with the CSEQ number to expect + for the next RTSP Server to Client request. + This feature (listening for Server requests) is unimplemented. + Defaults to 0. + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_SESSION_ID + (int) + + + + Set a string with the value of the current RTSP Session ID for the handle. + Once this value is set to any non-&null; value, + cURL returns CURLE_RTSP_SESSION_ERROR + if the ID received from the server does not match. + If set to &null;, cURL automatically sets the ID + the first time the server sets it in a response. + Defaults to &null; + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_STREAM_URI + (int) + + + + Sets a string with the stream URI to operate on. + If not set, cURL defaults to operating on generic server options + by passing * in the place of the RTSP Stream URI. + When working with RTSP, CURLOPT_RTSP_STREAM_URI + indicates what URL to send to the server in the request header + while the CURLOPT_URL indicates + where to make the connection to. + Available as of cURL 7.20.0. + + + + + + CURLOPT_RTSP_TRANSPORT + (int) + + + + Set the Transport: header for this RTSP session. + Available as of cURL 7.20.0. + + + + + + CURLOPT_SAFE_UPLOAD + (int) + + + + Always &true;, what disables support for the @ prefix for + uploading files in CURLOPT_POSTFIELDS, which + means that values starting with @ can be safely + passed as fields. CURLFile may be used for + uploads instead. + + + + + + CURLOPT_SASL_AUTHZID + (int) + + + + The authorization identity (authzid) string for the transfer. Only applicable to the PLAIN SASL + authentication mechanism where it is optional. When not specified, only the authentication identity + (authcid) as specified by the username will be sent to the server, along with the password. + The server will derive the authzid from the authcid when not provided, which it will then use internally. + Available as of PHP 8.2.0 and cURL 7.66.0. + + + + + + CURLOPT_SASL_IR + (int) + + + + &true; to enable sending the initial response in the first packet. + Available as of PHP 7.0.7 and cURL 7.31.0. + + + + + + CURLOPT_SERVICE_NAME + (int) + + + + A string with the authentication service name. + Available as of PHP 7.0.7 and cURL 7.43.0. + + + + + + CURLOPT_SHARE + (int) + + + + A result of curl_share_init. Makes the cURL + handle to use the data from the shared handle. + Available as of cURL 7.10. + + + + + + CURLOPT_SOCKS5_AUTH + (int) + + + + The SOCKS5 authentication method(s) to use. The options are: + + CURLAUTH_BASIC + CURLAUTH_GSSAPI + CURLAUTH_NONE + . + When more than one method is set, cURL will poll the server to see + what methods it supports and pick the best one. + Defaults to CURLAUTH_BASIC|CURLAUTH_GSSAPI. + Set the actual username and password with the CURLOPT_PROXYUSERPWD option. + Available as of PHP 7.3.0 and cURL 7.55.0. + + + + + + CURLOPT_SOCKS5_GSSAPI_NEC + (int) + + + + Set to 1 to enable and 0 to disable + the unprotected exchange of the protection mode negotiation + as part of the GSSAPI negotiation. + Available as of cURL 7.19.4. + + + + + + CURLOPT_SOCKS5_GSSAPI_SERVICE + (int) + + + + Set a string holding the name of the SOCKS5 service. + Defaults to rcmd. + Available as of cURL 7.19.4 and deprecated as of cURL 7.49.0. + Use CURLOPT_PROXY_SERVICE_NAME instead. + + + + + + CURLOPT_SSH_AUTH_TYPES + (int) + + + + A bitmask consisting of one or more of the following constants: + + CURLSSH_AUTH_PUBLICKEY + CURLSSH_AUTH_PASSWORD + CURLSSH_AUTH_HOST + CURLSSH_AUTH_KEYBOARD + CURLSSH_AUTH_AGENT + CURLSSH_AUTH_ANY + . + Defaults to CURLSSH_AUTH_ANY. + Available as of cURL 7.16.1. + + + + + + CURLOPT_SSH_COMPRESSION + (int) + + + + &true; to enable, &false; to disable built-in SSH compression. + Note that the server can disregard this request. + Defaults to &false;. + Available as of PHP 7.3.0 and cURL 7.56.0. + + + + + + CURLOPT_SSH_HOSTKEYFUNCTION + (int) + + + + A callable that will be called when SSH host key verification is needed. + The callback must have the following signature: + + intcallback + resourcecurlHandle + intkeyType + stringkey + intkeyLength + + + + curlHandle + + + The cURL handle. + + + + + keyType + + + One of the CURLKHTYPE_* key types. + + + + + key + + + The key to check. + + + + + keyLength + + + The length of the key in bytes. + + + + + This callback overrides CURLOPT_SSH_KNOWNHOSTS. + Available as of PHP 8.3.0 and cURL 7.84.0. + + + + + + CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 + (int) + + + + A string containing 32 hexadecimal digits which should contain the + MD5 checksum of the remote host's public key, and cURL will reject + the connection to the host unless the md5sums match. + This option is only for SCP and SFTP transfers. + Available as of cURL 7.17.1. + + + + + + CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 + (int) + + + + A string with the base64-encoded SHA256 hash + of the remote host's public key. + The transfer will fail if the given hash does not match the hash the remote host provides. + Available as of PHP 8.2.0 and cURL 7.80.0. + + + + + + CURLOPT_SSH_KNOWNHOSTS + (int) + + + + Set to the filename of the known_host file to use + which should use the OpenSSH file format as supported by libssh2. + Available as of cURL 7.19.6. + + + + + + CURLOPT_SSH_PRIVATE_KEYFILE + (int) + + + + The file name for a private key. If not used, cURL defaults to + $HOME/.ssh/id_dsa if the HOME environment variable is set, + and just id_dsa in the current directory if HOME is not set. + If the file is password-protected, set the password with + CURLOPT_KEYPASSWD. + Available as of cURL 7.16.1. + + + + + + CURLOPT_SSH_PUBLIC_KEYFILE + (int) + + + + The file name for a public key. If not used, cURL defaults to + $HOME/.ssh/id_dsa.pub if the HOME environment variable is set, + and just id_dsa.pub in the current directory if HOME is not set. + Available as of cURL 7.16.1. + + + + + + CURLOPT_SSLCERT + (int) + + + + The name of a file containing a PEM formatted certificate. + Available as of cURL 7.1.0. + + + + + + CURLOPT_SSLCERTPASSWD + (int) + + + + The password required to use the + CURLOPT_SSLCERT certificate. + Available as of cURL 7.1.0 and deprecated as of cURL 7.17.0. + + + + + + CURLOPT_SSLCERTTYPE + (int) + + + + A string with the format of the certificate. Supported formats are: + + PEM + DER + ENG + P12 + . + P12 (for PKCS#12-encoded files) is available as of OpenSSL 0.9.3. + Defaults to PEM. + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLCERT_BLOB + (int) + + + + A string with the SSL client certificate. + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_SSLENGINE + (int) + + + + The string identifier for the crypto engine of the private SSL key + specified in CURLOPT_SSLKEY. + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLENGINE_DEFAULT + (int) + + + + The string identifier for the crypto engine used for asymmetric crypto + operations. + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLKEY + (int) + + + + The name of a file containing a private SSL key. + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLKEYPASSWD + (int) + + + + The secret password needed to use the private SSL key specified in + CURLOPT_SSLKEY. + + + Since this option contains a sensitive password, remember to keep + the PHP script it is contained within safe. + + + Available as of cURL 7.9.3 and deprecated as of cURL 7.17.0. + + + + + + CURLOPT_SSLKEYTYPE + (int) + + + + The key type of the private SSL key specified in + CURLOPT_SSLKEY. Supported key types are: + + PEM + DER + ENG + . + Defaults to PEM. + Available as of cURL 7.9.3. + + + + + + CURLOPT_SSLKEY_BLOB + (int) + + + + A string private key for client cert. + Available as of PHP 8.1.0 and cURL 7.71.0. + + + + + + CURLOPT_SSLVERSION + (int) + + + + One of + the CURL_SSLVERSION_* constants. + + + It is better to not set this option and leave the defaults. + As setting this to + CURL_SSLVERSION_SSLv2 + or + CURL_SSLVERSION_SSLv3 + is very dangerous, given the known + vulnerabilities in SSLv2 and SSLv3. + + + Defaults to CURL_SSLVERSION_DEFAULT. + Available as of cURL 7.1.0. + + + + + + CURLOPT_SSL_CIPHER_LIST + (int) + + + + A colon-separated string of ciphers to use + for the TLS 1.2 (1.1, 1.0) connection. + Available as of cURL 7.9. + + + + + + CURLOPT_SSL_EC_CURVES + (int) + + + + A colon delimited list of elliptic curve algorithms. For example, + X25519:P-521 is a valid list of two elliptic curves. + This option defines the client's key exchange algorithms in the SSL handshake, + if the SSL backend cURL is built to use supports it. + Available as of PHP 8.2.0 and cURL 7.73.0. + + + + + + CURLOPT_SSL_ENABLE_ALPN + (int) + + + + &false; to disable ALPN in the SSL handshake (if the SSL backend + cURL is built to use supports it), which can be used to + negotiate http2. + Available as of PHP 7.0.7 and cURL 7.36.0. + + + + + + CURLOPT_SSL_ENABLE_NPN + (int) + + + + &false; to disable NPN in the SSL handshake (if the SSL backend + cURL is built to use supports it), which can be used to + negotiate 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; to enable and &false; to disable TLS false start + which is a mode where a TLS client starts sending application data + before verifying the server's Finished message. + Available as of PHP 7.0.7 and cURL 7.42.0. + + + + + + CURLOPT_SSL_OPTIONS + (int) + + + + Set SSL behavior options, which is a bitmask of the + CURLSSLOPT_* constants. + Defaults to none of the bits being set. + Available as of PHP 7.0.7. and cURL 7.25.0. + + + + + + CURLOPT_SSL_SESSIONID_CACHE + (int) + + + + Set to 0 to disable and 1 to enable + SSL session-ID caching. + By default all transfers are done using the cache enabled. + Available as of cURL 7.16.0. + + + + + + CURLOPT_SSL_VERIFYHOST + (int) + + + + 2 to verify that a Common Name field or a Subject Alternate Name + field in the SSL peer certificate matches the provided hostname. + 0 to not check the names. + 1 should not be used. + In production environments the value of this option + should be kept at 2 (default value). Support for value 1 removed in cURL 7.28.1. + Available as of cURL 7.8.1. + + + + + + CURLOPT_SSL_VERIFYPEER + (int) + + + + &false; to stop cURL from verifying the peer's + certificate. Alternate certificates to verify against can be + specified with the CURLOPT_CAINFO option + or a certificate directory can be specified with the + CURLOPT_CAPATH option. + Defaults to &true; as of cURL 7.10. + Default bundle of CA certificates installed as of cURL 7.10. + Available as of cURL 7.4.2. + + + + + + CURLOPT_SSL_VERIFYSTATUS + (int) + + + + &true; to enable and &false; to disable verification of the certificate's status. + Available as of PHP 7.0.7 and cURL 7.41.0. + + + + + + CURLOPT_STDERR + (int) + + + + Accepts a file handle resource pointing to + an alternative location to output errors to instead of + STDERR. + Available as of cURL 7.1.0. + + + + + + CURLOPT_STREAM_WEIGHT + (int) + + + + Set the numerical stream weight (a number between 1 and 256). + Available as of PHP 7.0.7 and cURL 7.46.0. + + + + + + CURLOPT_SUPPRESS_CONNECT_HEADERS + (int) + + + + &true; to suppress proxy CONNECT response headers from the user callback functions + CURLOPT_HEADERFUNCTION and CURLOPT_WRITEFUNCTION, + when CURLOPT_HTTPPROXYTUNNEL is used and a CONNECT request is made. + Defaults to &false;. + Available as of PHP 7.3.0 and cURL 7.54.0. + + + + + + CURLOPT_TCP_FASTOPEN + (int) + + + + &true; to enable and &false; to disable TCP Fast Open. + Available as of PHP 7.0.7 and cURL 7.49.0. + + + + + + CURLOPT_TCP_KEEPALIVE + (int) + + + + If set to 1, TCP keepalive probes will be sent. The delay and + frequency of these probes can be controlled by the CURLOPT_TCP_KEEPIDLE + and CURLOPT_TCP_KEEPINTVL options, provided the operating system + supports them. If set to 0 (default) keepalive probes are disabled. + The maximum number of probes can be set with the CURLOPT_TCP_KEEPCNT + option. + Available as of cURL 7.25.0. + + + + + + CURLOPT_TCP_KEEPIDLE + (int) + + + + Sets the delay, in seconds, that the operating system will wait while the connection is + idle before sending keepalive probes, if CURLOPT_TCP_KEEPALIVE is + enabled. Not all operating systems support this option. + The default is 60. + Available as of cURL 7.25.0. + + + + + + CURLOPT_TCP_KEEPINTVL + (int) + + + + Sets the interval, in seconds, that the operating system will wait between sending + keepalive probes, if CURLOPT_TCP_KEEPALIVE is enabled. + Not all operating systems support this option. + The default is 60. + Available as of cURL 7.25.0. + + + + + + CURLOPT_TCP_KEEPCNT + (int) + + + + Sets the maximum number of TCP keep-alive probes. + The default is 9. + Available as of PHP 8.4.0 and cURL 8.9.0. + + + + + + CURLOPT_TCP_NODELAY + (int) + + + + &true; to disable TCP's Nagle algorithm, which tries to minimize + the number of small packets on the network. + Defaults to &true;. + Available as of cURL 7.11.2. + + + + + + CURLOPT_TELNETOPTIONS + (int) + + + + Set an array of strings to pass to the telnet negotiations. + The variables should be in the format >option=value<. + cURL supports the options TTYPE, + XDISPLOC and NEW_ENV. + Available as of cURL 7.7.0. + + + + + + CURLOPT_TFTP_BLKSIZE + (int) + + + + Set the blocksize to use for TFTP data transmission. + Valid range is 8-65464 bytes. + The default of 512 bytes is used if this option is not specified. + The specified block size is only used if supported by the remote server. + If the server does not return an option acknowledgment + or returns an option acknowledgment with no block size, + the default of 512 bytes is used. + Available as of cURL 7.19.4. + + + + + + CURLOPT_TFTP_NO_OPTIONS + (int) + + + + &true; to not send TFTP options requests. + Defaults to &false;. + Available as of PHP 7.0.7 and cURL 7.48.0. + + + + + + CURLOPT_TIMECONDITION + (int) + + + + Set how CURLOPT_TIMEVALUE is treated. + Use CURL_TIMECOND_IFMODSINCE to return the + page only if it has been modified since the time specified in + CURLOPT_TIMEVALUE. If it hasn't been modified, + a 304 Not Modified header will be returned + assuming CURLOPT_HEADER is &true;. + Use CURL_TIMECOND_IFUNMODSINCE for the reverse + effect. Use CURL_TIMECOND_NONE to ignore + CURLOPT_TIMEVALUE and always return the page. + CURL_TIMECOND_NONE is the default. + Prior to cURL 7.46.0 the default was + CURL_TIMECOND_IFMODSINCE. + Available as of cURL 7.1.0. + + + + + + CURLOPT_TIMEOUT + (int) + + + + The maximum number of seconds to allow cURL functions to execute. + Defaults to 0, meaning that functions never time out during transfer. + Available as of cURL 7.1.0. + + + + + + CURLOPT_TIMEOUT_MS + (int) + + + + The maximum number of milliseconds to allow cURL functions to + execute. + If cURL is built to use the standard system name resolver, that + portion of the connect will still use full-second resolution for + timeouts with a minimum timeout allowed of one second. + Defaults to 0, meaning that functions never time out during transfer. + Available as of cURL 7.16.2. + + + + + + CURLOPT_TIMEVALUE + (int) + + + + The time in seconds since January 1st, 1970. The time will be used + by CURLOPT_TIMECONDITION. + Defaults to 0. + Available as of cURL 7.1.0. + + + + + + CURLOPT_TIMEVALUE_LARGE + (int) + + + + The time in seconds since January 1st, 1970. The time will be used + by CURLOPT_TIMECONDITION. Defaults to zero. + The difference between this option and CURLOPT_TIMEVALUE + is the type of the argument. On systems where 'long' is only 32 bit wide, + this option has to be used to set dates beyond the year 2038. + Available as of PHP 7.3.0 and cURL 7.59.0. + + + + + + CURLOPT_TLS13_CIPHERS + (int) + + + + A string with a colon-separated list of ciphers + to use for the connection to the TLS 1.3 connection. + This option is currently used only when cURL is built to use OpenSSL 1.1.1 or later. + When using a different SSL backend the TLS 1.3 cipher suites can be set + with the CURLOPT_SSL_CIPHER_LIST option. + Available as of PHP 7.3.0 and cURL 7.61.0. + + + + + + CURLOPT_TLSAUTH_PASSWORD + (int) + + + + Set a password to use for the TLS authentication method specified + with the CURLOPT_TLSAUTH_TYPE option. Requires that + the CURLOPT_TLSAUTH_USERNAME option also be set. + This feature relies on TLS SRP which does not work with TLS 1.3. + Available as of cURL 7.21.4. + + + + + + CURLOPT_TLSAUTH_TYPE + (int) + + + + Set a string with the method of the TLS authentication. + Supported method is SRP + (TLS Secure Remote Password authentication). + Available as of cURL 7.21.4. + + + + + + CURLOPT_TLSAUTH_USERNAME + (int) + + + + Set a string with the username to use for the TLS authentication method + specified with the CURLOPT_TLSAUTH_TYPE option. + Requires that the CURLOPT_TLSAUTH_PASSWORD option + also be set. + This feature relies on TLS SRP which does not work with TLS 1.3. + Available as of cURL 7.21.4. + + + + + + CURLOPT_TRANSFER_ENCODING + (int) + + + + Set to 1 to enable and 0 to disable + requesting compressed Transfer Encoding in the outgoing + HTTP request. If the server responds with a compressed + Transfer Encoding, + cURL will automatically uncompress it on reception. + Defaults to 0. + Available as of cURL 7.21.6. + + + + + + CURLOPT_TRANSFERTEXT + (int) + + + + &true; to use ASCII mode for FTP transfers. + For LDAP, it retrieves data in plain text instead of HTML. On + Windows systems, it will not set STDOUT to binary + mode. + Defaults to &false;. + Available as of cURL 7.1.1. + + + + + + CURLOPT_UNIX_SOCKET_PATH + (int) + + + + Enables the use of Unix domain sockets as connection endpoint and + sets the path to the given string. + Set to &null; to disable. + Defaults to &null;. + Available as of PHP 7.0.7 and cURL 7.40.0. + + + + + + CURLOPT_UNRESTRICTED_AUTH + (int) + + + + &true; to keep sending the username and password + when following locations (using + CURLOPT_FOLLOWLOCATION), even when the + hostname has changed. + Defaults to &false;. + Available as of cURL 7.10.4. + + + + + + CURLOPT_UPKEEP_INTERVAL_MS + (int) + + + + Some protocols have "connection upkeep" mechanisms. These mechanisms usually send some traffic + on existing connections in order to keep them alive. This option defines the connection upkeep interval. + Currently, the only protocol with a connection upkeep mechanism is HTTP/2. When the connection upkeep + interval is exceeded, an HTTP/2 PING frame is sent on the connection. + Defaults to CURL_UPKEEP_INTERVAL_DEFAULT + which is currently 60 seconds. + Available as of PHP 8.2.0 and cURL 7.62.0. + + + + + + CURLOPT_UPLOAD + (int) + + + + &true; to prepare for and perform an upload. + Defaults to &false;. + Available as of cURL 7.1.0. + + + + + + CURLOPT_UPLOAD_BUFFERSIZE + (int) + + + + Preferred buffer size in bytes for the cURL upload buffer. + The upload buffer size by default is 64 kilobytes. The maximum buffer size allowed to be set is 2 megabytes. + The minimum buffer size allowed to be set is 16 kilobytes. + Available as of PHP 8.2.0 and cURL 7.62.0. + + + + + + CURLOPT_URL + (int) + + + + The URL to fetch. This can also be set when initializing a + session with curl_init. + Available as of cURL 7.1.0. + + + + + + CURLOPT_USE_SSL + (int) + + + + Sets the desired level of SSL/TLS for the transfer + when using FTP, SMTP, POP3, IMAP, etc. + These are all protocols that start out plain text + and get "upgraded" to SSL using the STARTTLS command. + Set to one of the + CURLUSESSL_* constants. + Available as of cURL 7.17.0. + + + + + + CURLOPT_USERAGENT + (int) + + + + The contents of the User-Agent: header to be + used in a HTTP request. + Available as of cURL 7.1.0. + + + + + + CURLOPT_USERNAME + (int) + + + + The user name to use in authentication. + Available as of cURL 7.19.1. + + + + + + CURLOPT_USERPWD + (int) + + + + A username and password formatted as + [username]:[password] to use for the + connection. + Available as cURL 7.1.0. + + + + + + CURLOPT_VERBOSE + (int) + + + + &true; to output verbose information. Writes + output to STDERR, or the file specified using + CURLOPT_STDERR. + Defaults to &false;. + Available as of cURL 7.1.0. + + + + + + CURLOPT_WILDCARDMATCH + (int) + + + + Set to 1 to transfer multiple files + according to a filename pattern. + The pattern can be specified as part of the + CURLOPT_URL option, + using an fnmatch-like pattern (Shell Pattern Matching) + in the last part of URL (filename). + Available as of cURL 7.21.0. + + + + + + CURLOPT_WRITEFUNCTION + (int) + + + + A callable with the following signature: + + intcallback + resourcecurlHandle + stringdata + + + + curlHandle + + + The cURL handle. + + + + + data + + + The data to be written. + + + + + The data must be saved by the callback + and the callback must return the exact number of bytes written + or the transfer will be aborted with an error. + Available as of cURL 7.1.0. + + + + + + CURLOPT_WRITEHEADER + (int) + + + + Accepts a file handle resource to the file that the header part of the transfer is written to. + Available as of cURL 7.1.0. + + + + + + CURLOPT_WS_OPTIONS + (int) + + + + Accepts a bitmask setting WebSocket behavior options. + The only available option is CURLWS_RAW_MODE. + Defaults to 0. + Available as of PHP 8.3.0 and cURL 7.86.0. + + + + + + CURLOPT_XFERINFOFUNCTION + (int) + + + + A callable with the following signature: + + intcallback + resourcecurlHandle + intbytesToDownload + intbytesDownloaded + intbytesToUpload + intbytesUploaded + + + + curlHandle + + + The cURL handle. + + + + + bytesToDownload + + + The total number of bytes expected to be downloaded in this transfer. + + + + + bytesDownloaded + + + The number of bytes downloaded so far. + + + + + bytesToUpload + + + The total number of bytes expected to be uploaded in this transfer. + + + + + bytesUploaded + + + The number of bytes uploaded so far. + + + + + Return 1 to abort the transfer + and set a CURLE_ABORTED_BY_CALLBACK error. + Available as of PHP 8.2.0 and cURL 7.32.0. + + + + + + CURLOPT_SERVER_RESPONSE_TIMEOUT + (int) + + + + A timeout in seconds cURL will wait for a response from an + FTP, SFTP, IMAP, + SCP, SMTP, or a POP3 server. + This option replaces the existing CURLOPT_FTP_RESPONSE_TIMEOUT + option which is deprecated in cURL 7.85.0. + Available as of PHP 8.4.0. + + + + + + CURLOPT_XOAUTH2_BEARER + (int) + + + + Specifies the OAuth 2.0 access token. + Set to &null; to disable. + Defaults to &null;. + Available as of PHP 7.0.7 and cURL 7.33.0. + + + + + + CURLOPT_PREREQFUNCTION + (int) + + + + A callable with the following signature that gets called after the + connection is established, but before the request payload (for example, the + GET/POST/DELETE request of an HTTP connection) is sent, and can be used to abort + or allow the connection depending on the source and destination IP address and + port numbers: + + intcallback + CurlHandlecurlHandle + stringdestination_ip + stringlocal_ip + intdestination_port + intlocal_port + + + + curlHandle + + + The cURL handle. + + + + + destination_ip + + + The primary IP of the remote server established with this connection. + For FTP, this is the IP for the control connection. + IPv6 addresses are represented without surrounding brackets. + + + + + local_ip + + + The originating IP for this connection. + IPv6 addresses are represented without surrounding brackets. + + + + + destination_port + + + The primary port number on the remote server established with this connection. + For FTP, this is the port for the control connection. + This can be a TCP or a UDP port number depending on the protocol. + + + + + local_port + + + The originating port number for this connection. + This can be a TCP or a UDP port number depending on the protocol. + + + + + Return CURL_PREREQFUNC_OK to allow the request, or + CURL_PREREQFUNC_ABORT to abort the transfer. + Available as of PHP 8.4.0 and cURL 7.80.0. + + + + + + CURLOPT_DEBUGFUNCTION + (int) + + + + Available as of PHP 8.4.0. + This option requires CURLOPT_VERBOSE option enabled. + A callable to replace the standard cURL verbose output. + This callback gets called during various stages of the request with verbose debug information. + The callback should match the following signature: + + voidcallback + CurlHandlecurlHandle + inttype + stringdata + + + + curlHandle + + + The cURL handle. + + + + + type + + + One of the following constants indicating the type of the data value: + + + + + CURLINFO_TEXT + (int) + + + + Informational text. + + + + + + CURLINFO_HEADER_IN + (int) + + + + Header (or header-like) data received from the peer. + + + + + + CURLINFO_HEADER_OUT + (int) + + + + Header (or header-like) data sent to the peer. + + + + + + CURLINFO_DATA_IN + (int) + + + + Unprocessed protocol data received from the peer. + Even if the data is encoded or compressed, it is not provided decoded nor decompressed to this callback. + + + + + + CURLINFO_DATA_OUT + (int) + + + + Protocol data sent to the peer. + + + + + + CURLINFO_SSL_DATA_IN + (int) + + + + SSL/TLS (binary) data received from the peer. + + + + + + CURLINFO_SSL_DATA_OUT + (int) + + + + SSL/TLS (binary) data sent to the peer. + + + + + + + + data + + + Verbose debug data of the type indicate by the type parameter. + + + + + + + + From 2cd667f17e1c1a8b98e66668399a62ee136414e4 Mon Sep 17 00:00:00 2001 From: nsfisis Date: Mon, 12 May 2025 01:26:01 +0900 Subject: [PATCH 3/7] =?UTF-8?q?wip:=20=E9=80=B2=E6=8D=97=E7=8E=87=2018=20%?= =?UTF-8?q?=20=E3=81=8F=E3=82=89=E3=81=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/curl/constants_curl_setopt.xml | 802 ++++++++++++----------- 1 file changed, 408 insertions(+), 394 deletions(-) diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index 0698f56754..421f96ab31 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -16,7 +16,7 @@ as CURLOPT_UNIX_SOCKET_PATH. These two options share the same storage and therefore only one of them can be set per handle. - Available as of PHP 7.3.0 and cURL 7.53.0. + PHP 7.3.0 以降かつ cURL 7.53.0 以降で利用可能です。 @@ -27,11 +27,11 @@ - Sets a string with the contents - of the Accept-Encoding: header sent in an HTTP request. - Set to &null; to disable sending the Accept-Encoding: header. - Defaults to &null;. - Available as of cURL 7.21.6. + HTTP リクエストの中で送られる Accept-Encoding: ヘッダの内容を + string で指定します。 + &null; をセットすると、Accept-Encoding: ヘッダの送信を無効にします。 + デフォルト値は &null; です。 + cURL 7.21.6 以降で利用可能です。 @@ -42,11 +42,12 @@ - The maximum number of milliseconds to wait for a server - to connect back to cURL when an active FTP connection is used. - This option accepts any value that can be cast to a valid int. - Defaults to 60000 milliseconds. - Available as of cURL 7.24.0. + !!! "active FTP connection" + アクティブな FTP 接続を使用している場合に、 + cURL がサーバーからの接続を待機する最大ミリ秒数。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は 60000 ミリ秒です。 + cURL 7.24.0 以降で利用可能です。 @@ -57,10 +58,10 @@ - The scope id value to use when connecting to IPv6 addresses. - This option accepts any value that can be cast to a valid int. - Defaults to 0. - Available as of cURL 7.19.0. + IPv6 アドレスに接続する際に使用するスコープ ID の値を指定します。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は 0 です。 + cURL 7.19.0 以降で利用可能です。 @@ -71,10 +72,11 @@ + !!! Alt-Svc Pass a string with the filename for cURL to use as the Alt-Svc cache file to read existing cache contents from and possibly also write it back to a after a transfer, unless CURLALTSVC_READONLYFILE is set via CURLOPT_ALTSVC_CTRL. - Available as of PHP 8.2.0 and cURL 7.64.1. + PHP 8.2.0 以降かつ cURL 7.64.1 以降で利用可能です。 @@ -85,6 +87,7 @@ + !!! Alt-Svc Populate the bitmask with the correct set of features to instruct cURL how to handle Alt-Svc for the transfers using this handle. cURL only accepts Alt-Svc headers over HTTPS. It will also only complete a request to an alternative origin if that origin is properly hosted over HTTPS. @@ -92,7 +95,7 @@ Set to any of the CURLALTSVC_* constants. Defaults to Alt-Svc handling being disabled. - Available as of PHP 8.2.0 and cURL 7.64.1. + PHP 8.2.0 以降かつ cURL 7.64.1 以降で利用可能です。 @@ -103,10 +106,10 @@ - Setting this option to 1 will cause FTP uploads - to append to the remote file instead of overwriting it. - Defaults to 0. - Available as of cURL 7.17.0. + このオプションを 1 に設定すると、FTP アップロード時に + リモートファイルを上書きするのではなく、末尾に追加するようになります。 + デフォルト値は 0 です。 + cURL 7.17.0 以降で利用可能です。 @@ -117,10 +120,10 @@ - &true; to automatically set the Referer: field in - requests where it follows a Location: redirect. - Defaults to 0. - Available as of cURL 7.1.0. + &true; を指定すると、リクエストが Location: のリダイレクトによるものである場合、 + 自動的に Referer: ヘッダを設定します。 + デフォルト値は 0 です。 + cURL 7.1.0 以降で利用可能です。 @@ -131,10 +134,10 @@ - Provides AWS V4 signature authentication on HTTP(S) header as a string. - This option overrides any other authentication types that have been set in - CURLOPT_HTTPAUTH. This method cannot be combined with other authentication types. - Available as of PHP 8.2.0 and cURL 7.75.0. + AWS V4 署名認証を HTTP(S) ヘッダに string として指定します。 + このオプションは、CURLOPT_HTTPAUTH で設定された + 他の認証方法を上書きします。これと他の認証方法を組み合わせることはできません。 + PHP 8.2.0 以降かつ cURL 7.75.0 以降で利用可能です。 @@ -145,8 +148,8 @@ - This constant is no longer used as of PHP 5.5.0. - Deprecated as of PHP 8.4.0. + この定数は PHP 5.5.0 以降は用いられていません。 + PHP 8.4.0 以降は非推奨となっています。 @@ -157,11 +160,11 @@ - The size of the buffer to use for each read. There is no guarantee - this request will be fulfilled, however. - This option accepts any value that can be cast to a valid int. - Defaults to CURL_MAX_WRITE_SIZE (currently, 16kB). - Available as of cURL 7.10. + 各読込で使用するバッファサイズ。 + ただし、必ずしも指定した値が使われるとは限りません。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は CURL_MAX_WRITE_SIZE (現在は 16kB) です。 + cURL 7.10 以降で利用可能です。 @@ -172,10 +175,12 @@ - A string with the name of a file holding one or more certificates to verify the - peer with. This only makes sense when used in combination with - CURLOPT_SSL_VERIFYPEER. Might require an absolute path. - Available as of cURL 7.4.2. + !!! "one or more" + !!! CURLOPT_CAINFO_BLOB との差は？ + 相手を検証するための証明書を格納したファイル名を string で指定します。 + このオプションは、CURLOPT_SSL_VERIFYPEER と組み合わせて用いた場合のみ意味を持ちます。 + 絶対パスを指定する必要があるかもしれません。 + cURL 7.4.2 以降で利用可能です。 @@ -186,9 +191,11 @@ - A string with the name of a PEM file holding one or more certificates to verify the - peer with. This option overrides CURLOPT_CAINFO. - Available as of PHP 8.2.0 and cURL 7.77.0. + !!! "one or more" + !!! CURLOPT_CAINFO との差は？ + 相手を検証するための証明書を格納した PEM ファイル名を string で指定します。 + このオプションは CURLOPT_CAINFO を上書きします。 + PHP 8.2.0 以降かつ cURL 7.77.0 以降で利用可能です。 @@ -199,9 +206,9 @@ - A string with a directory that holds multiple CA certificates. - Use this option alongside CURLOPT_SSL_VERIFYPEER. - Available as of cURL 7.9.8. + 複数の CA 証明書を格納したディレクトリを string で指定します。 + CURLOPT_SSL_VERIFYPEER と一緒に使用してください。 + cURL 7.9.8 以降で利用可能です。 @@ -212,11 +219,12 @@ + !!! Sets the maximum time in seconds any in memory cached CA certificate store may be kept and reused for new connections. - This option accepts any value that can be cast to a valid int. - Defaults to 86400 (24 hours). - Available as of PHP 8.3.0 and cURL 7.87.0 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は 86400 (24 時間) です。 + PHP 8.3.0 以降かつ cURL 7.87.0 以降で利用可能です。 @@ -227,11 +235,12 @@ + !!! &true; to output SSL certification information to STDERR on secure transfers. Requires CURLOPT_VERBOSE to be on to have an effect. - Defaults to &false;. - Available as of cURL 7.19.1. + デフォルト値は &false; です。 + cURL 7.19.1 以降で利用可能です。 @@ -242,11 +251,11 @@ - The number of seconds to wait while trying to connect. Use 0 to - wait indefinitely. - This option accepts any value that can be cast to a valid int. - Defaults to 300. - Available as of cURL 7.7.0. + 接続するまでの最大待機秒数。 + 0 を指定するといつまでも待機します。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は 300 です。 + cURL 7.7.0 以降で利用可能です。 @@ -257,14 +266,15 @@ - The number of milliseconds to wait while trying to connect. - Use 0 to wait indefinitely. + 接続するまでの最大待機ミリ秒数。 + 0 を指定するといつまでも待機します。 + !!! If cURL is built to use the standard system name resolver, that portion of the connect will still use full-second resolution for timeouts with a minimum timeout allowed of one second. - This option accepts any value that can be cast to a valid int. - Defaults to 300000. - Available as of cURL 7.16.2. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は 300000 です。 + cURL 7.16.2 以降で利用可能です。 @@ -275,11 +285,12 @@ + !!! &true; tells the library to perform all the required proxy authentication and connection setup, but no data transfer. This option is implemented for HTTP, SMTP and POP3. - Defaults to &false;. - Available as of cURL 7.15.2. + デフォルト値は &false; です。 + cURL 7.15.2 以降で利用可能です。 @@ -290,10 +301,11 @@ + !!! Connect to a specific host and port instead of the URL's host and port. Accepts an array of strings with the format HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. - Available as of PHP 7.0.7 and cURL 7.49.0. + PHP 7.0.7 以降かつ cURL 7.49.0 以降で利用可能です。 @@ -304,10 +316,11 @@ + !!! A string with the contents of the Cookie: header to be used in the HTTP request. Note that multiple cookies are separated with a semicolon followed by a space (e.g., fruit=apple; colour=red). - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -318,11 +331,12 @@ + !!! A string with the name of the file containing the cookie data. The cookie file can be in Netscape format, or just plain HTTP-style headers dumped into a file. If the name is an empty string, no cookies are loaded, but cookie handling is still enabled. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -333,9 +347,10 @@ + !!! A string with the name of a file to save all internal cookies to when the handle's destructor is called. - Available as of cURL 7.9.0. + cURL 7.9.0 以降で利用可能です。 As of PHP 8.0.0, curl_close is a no-op @@ -374,7 +389,7 @@ loads all cookies from the files specified by CURLOPT_COOKIEFILE . - Available as of cURL 7.14.1. + cURL 7.14.1 以降で利用可能です。 @@ -391,7 +406,7 @@ loads all cookies, independent if they are session cookies or not. Session cookies are cookies without expiry date and they are meant to be alive and existing for this "session" only. - Available as of cURL 7.9.7. + cURL 7.9.7 以降で利用可能です。 @@ -404,7 +419,7 @@ &true; to convert Unix newlines to CRLF newlines on transfers. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -429,7 +444,7 @@ Also note that CURLOPT_CRLFILE implies CURLSSLOPT_NO_PARTIALCHAIN as of cURL 7.71.0 due to an OpenSSL bug. - Available as of cURL 7.19.0. + cURL 7.19.0 以降で利用可能です。 @@ -450,7 +465,7 @@ entering GET /index.html HTTP/1.0\r\n\r\n would be incorrect. This option accepts a string or &null;. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 Don't do this without making sure the server supports the custom @@ -468,7 +483,7 @@ A string with the default protocol to use if the URL is missing a scheme name. - Available as of PHP 7.0.7 and cURL 7.45.0. + PHP 7.0.7 以降かつ cURL 7.45.0 以降で利用可能です。 @@ -487,8 +502,8 @@ as directories are always listed in this mode. Using this option with CURLOPT_WILDCARDMATCH will prevent the latter from having any effect. - Defaults to 0. - Available as of cURL 7.17.0. + デフォルト値は 0 です。 + cURL 7.17.0 以降で利用可能です。 @@ -501,7 +516,7 @@ &true; to not allow URLs that include a username. Usernames are allowed by default. - Available as of PHP 7.3.0 and cURL 7.61.0. + PHP 7.3.0 以降かつ cURL 7.61.0 以降で利用可能です。 @@ -514,8 +529,8 @@ The number of seconds to keep DNS entries in memory. This option is set to 120 (2 minutes) by default. - This option accepts any value that can be cast to a valid int. - Available as of cURL 7.9.3. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + cURL 7.9.3 以降で利用可能です。 @@ -529,7 +544,7 @@ Set the name of the network interface that the DNS resolver should bind to. This must be an interface name (not an address). This option accepts a string or &null;. - Available as of PHP 7.0.7 and cURL 7.33.0 + PHP 7.0.7 以降かつ cURL 7.33.0 以降で利用可能です。 @@ -543,7 +558,7 @@ Set the local IPv4 address that the resolver should bind to. The argument should contain a single numerical IPv4 address. This option accepts a string or &null;. - Available as of PHP 7.0.7 and cURL 7.33.0. + PHP 7.0.7 以降かつ cURL 7.33.0 以降で利用可能です。 @@ -557,7 +572,7 @@ Set the local IPv6 address that the resolver should bind to. The argument should contain a single numerical IPv6 address. This option accepts a string or &null;. - Available as of PHP 7.0.7 and cURL 7.33.0. + PHP 7.0.7 以降かつ cURL 7.33.0 以降で利用可能です。 @@ -571,7 +586,7 @@ Pass a string with a comma-separated list of DNS servers to be used instead of the system default (e.g.: 192.168.1.100,192.168.1.101:8080). - Available as of cURL 7.24.0. + cURL 7.24.0 以降で利用可能です。 @@ -585,7 +600,7 @@ &true; to shuffle the order of all returned addresses so that they will be used in a random order, when a name is resolved and more than one IP address is returned. This may cause IPv4 to be used before IPv6 or vice versa. - Available as of PHP 7.3.0 and cURL 7.60.0. + PHP 7.3.0 以降かつ cURL 7.60.0 以降で利用可能です。 @@ -599,7 +614,7 @@ &true; to use a global DNS cache. This option is not thread-safe. It is conditionally enabled by default if PHP is built for non-threaded use (CLI, FCGI, Apache2-Prefork, etc.). - Available as of cURL 7.9.3 and deprecated as of cURL 7.11.1. + cURL 7.9.3 以降で利用可能ですが、cURL 7.11.1 以降は非推奨となりました。 As of PHP 8.4, this option no longer has any effect. @@ -612,7 +627,7 @@ Set to 2 to verify the DNS-over-HTTPS server's SSL certificate name fields against the host name. - Available as of PHP 8.2.0 and cURL 7.76.0. + PHP 8.2.0 以降かつ cURL 7.76.0 以降で利用可能です。 @@ -625,7 +640,7 @@ Set to 1 to enable and 0 to disable verification of the authenticity of the DNS-over-HTTPS server's SSL certificate. - Available as of PHP 8.2.0 and cURL 7.76.0. + PHP 8.2.0 以降かつ cURL 7.76.0 以降で利用可能です。 @@ -639,7 +654,7 @@ Set to 1 to enable and 0 to disable the verification of the status of the DNS-over-HTTPS server certificate using the "Certificate Status Request" TLS extension (OCSP stapling). - Available as of PHP 8.2.0 and cURL 7.76.0. + PHP 8.2.0 以降かつ cURL 7.76.0 以降で利用可能です。 @@ -652,7 +667,7 @@ Provides the DNS-over-HTTPS URL. This option accepts a string or &null;. - Available as of PHP 8.1.0 and cURL 7.62.0. + PHP 8.1.0 以降かつ cURL 7.62.0 以降で利用可能です。 @@ -665,7 +680,7 @@ Like CURLOPT_RANDOM_FILE, except a filename to an Entropy Gathering Daemon socket. - Available as of cURL 7.7.0 and deprecated as of cURL 7.84.0. + cURL 7.7.0 以降で利用可能ですが、cURL 7.84.0 以降は非推奨となりました。 @@ -685,7 +700,7 @@ . If an empty string is set, a header containing all supported encoding types is sent. - Available as of cURL 7.10 and deprecated as of cURL 7.21.6. + cURL 7.10 以降で利用可能ですが、cURL 7.21.6 以降は非推奨となりました。 @@ -697,9 +712,9 @@ The timeout for Expect: 100-continue responses in milliseconds. - Defaults to 1000 milliseconds. - This option accepts any value that can be cast to a valid int. - Available as of PHP 7.0.7 and cURL 7.36.0. + デフォルト値は 1000 ミリ秒です。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + PHP 7.0.7 以降かつ cURL 7.36.0 以降で利用可能です。 @@ -713,7 +728,7 @@ &true; to fail verbosely if the HTTP code returned is greater than or equal to 400. The default behavior is to return the page normally, ignoring the code. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -727,7 +742,7 @@ Accepts a file handle resource to the file that the transfer should be written to. The default is STDOUT (the browser window). - Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7. + cURL 7.1.0 以降で利用可能ですが、cURL 7.9.7 以降は非推奨となりました。 @@ -742,7 +757,7 @@ date of the remote document. This value can be retrieved using the CURLINFO_FILETIME option with curl_getinfo. - Available as of cURL 7.5.0. + cURL 7.5.0 以降で利用可能です。 @@ -791,7 +806,7 @@ CURL_FNMATCHFUNC_MATCH if pattern matches the string, CURL_FNMATCHFUNC_NOMATCH if not or CURL_FNMATCHFUNC_FAIL if an error occurred. - Available as of cURL 7.21.0. + cURL 7.21.0 以降で利用可能です。 @@ -807,7 +822,7 @@ See also CURLOPT_MAXREDIRS. This constant is not available when open_basedir is enabled. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -820,7 +835,7 @@ Set to &true; to force the connection to explicitly close when it has finished processing, and not be pooled for reuse. - Available as of cURL 7.7.0. + cURL 7.7.0 以降で利用可能です。 @@ -833,7 +848,7 @@ Set to &true; to force the use of a new connection instead of a cached one. - Available as of cURL 7.7.0. + cURL 7.7.0 以降で利用可能です。 @@ -846,7 +861,7 @@ Set to &true; to append to the remote file instead of overwriting it. - Available as of cURL 7.1.0 and deprecated as of cURL 7.16.4. + cURL 7.1.0 以降で利用可能ですが、cURL 7.16.4 以降は非推奨となりました。 @@ -857,11 +872,10 @@ - An alias of - CURLOPT_TRANSFERTEXT. Use that instead. - Available as of cURL 7.1, deprecated as of cURL 7.11.1 - and last available in cURL 7.15.5. - Removed as of PHP 7.3.0. + CURLOPT_TRANSFERTEXT のエイリアスです。そちらを使用してください。 + cURL 7.1 以降で利用可能でしたが、cURL 7.11.1 からは非推奨となっており、 + cURL 7.15.5 を最後に削除されました。 + PHP 7.3.0 で削除されました。 @@ -873,7 +887,7 @@ Set to &true; to only list the names of an FTP directory. - Available as of cURL 7.1.0 and deprecated as of cURL 7.16.4. + cURL 7.1.0 以降で利用可能ですが、cURL 7.16.4 以降は非推奨となりました。 @@ -890,7 +904,7 @@ a network interface name (under Unix), or just a plain - to use the system's default IP address. This option accepts a string or &null;. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -903,8 +917,8 @@ Set the FTP over SSL authentication method (if activated) to any of the CURLFTPAUTH_* constants. - Defaults to CURLFTPAUTH_DEFAULT. - Available as of cURL 7.12.2. + デフォルト値は CURLFTPAUTH_DEFAULT です。 + cURL 7.12.2 以降で利用可能です。 @@ -919,8 +933,8 @@ (using the ACCT command) after username and password has been provided to the server. Set to &null; to disable sending the account information. - Defaults to &null;. - Available as of cURL 7.13.0. + デフォルト値は &null; です。 + cURL 7.13.0 以降で利用可能です。 @@ -933,7 +947,7 @@ Pass a string that will be used to try to authenticate over FTP if the USER/PASS negotiation fails. - Available as of cURL 7.15.5. + cURL 7.15.5 以降で利用可能です。 @@ -946,7 +960,7 @@ Set to &true; to create missing directories when an FTP operation encounters a path that currently doesn't exist. - Available as of cURL 7.10.7. + cURL 7.10.7 以降で利用可能です。 @@ -959,8 +973,8 @@ Tell cURL which method to use to reach a file on a FTP(S) server. Possible values are any of the CURLFTPMETHOD_* constants. - Defaults to CURLFTPMETHOD_MULTICWD. - Available as of cURL 7.15.1. + デフォルト値は CURLFTPMETHOD_MULTICWD です。 + cURL 7.15.1 以降で利用可能です。 @@ -971,12 +985,12 @@ - A timeout in seconds cURL will wait for a response from an FTP server. - This option overrides CURLOPT_TIMEOUT. - This option accepts any value that can be cast to a valid int. - This option name is replaced with CURLOPT_SERVER_RESPONSE_TIMEOUT, - available as of PHP 8.4.0. - Available as of cURL 7.10.8 and deprecated as of cURL 7.85.0. + FTP サーバからのレスポンスを待機するタイムアウト秒数。 + このオプションは CURLOPT_TIMEOUT を上書きします。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + このオプション名は PHP 8.4.0 で CURLOPT_SERVER_RESPONSE_TIMEOUT + へ置き換えられました。 + cURL 7.10.8 以降で利用可能ですが、cURL 7.85.0 以降は非推奨となりました。 @@ -994,7 +1008,7 @@ The port number received from the 227-response will not be ignored by cURL. Defaults to 1 as of cURL 7.74.0 and 0 prior to that. - Available as of cURL 7.15.0. + cURL 7.15.0 以降で利用可能です。 @@ -1005,7 +1019,7 @@ - Available as of cURL 7.11.0 and deprecated as of cURL 7.16.4. + cURL 7.11.0 以降で利用可能ですが、cURL 7.16.4 以降は非推奨となりました。 @@ -1020,8 +1034,8 @@ which shuts down the SSL/TLS layer after authenticating making the rest of the control channel communication unencrypted. Use one of the CURLFTPSSL_CCC_* constants. - Defaults to CURLFTPSSL_CCC_NONE. - Available as of cURL 7.16.1. + デフォルト値は CURLFTPSSL_CCC_NONE です。 + cURL 7.16.1 以降で利用可能です。 @@ -1034,7 +1048,7 @@ Set to &true; to use EPRT (and LPRT) when doing active FTP downloads. Set to &false; to disable EPRT and LPRT and use PORT only. - Available as of cURL 7.10.5. + cURL 7.10.5 以降で利用可能です。 @@ -1047,7 +1061,7 @@ Set to &true; to first try an EPSV command for FTP transfers before reverting back to PASV. Set to &false; to disable EPSV. - Available as of cURL 7.9.2. + cURL 7.9.2 以降で利用可能です。 @@ -1061,8 +1075,8 @@ Set to 1 to send a PRET command before PASV (and EPSV). Has no effect when using the active FTP transfers mode. - Defaults to 0. - Available as of cURL 7.20.0. + デフォルト値は 0 です。 + cURL 7.20.0 以降で利用可能です。 @@ -1078,8 +1092,8 @@ Set to CURLGSSAPI_DELEGATION_POLICY_FLAG to delegate only if the OK-AS-DELEGATE flag is set in the service ticket. - Defaults to CURLGSSAPI_DELEGATION_NONE. - Available as of cURL 7.22.0. + デフォルト値は CURLGSSAPI_DELEGATION_NONE です。 + cURL 7.22.0 以降で利用可能です。 @@ -1093,9 +1107,9 @@ Head start for IPv6 for the happy eyeballs algorithm. Happy eyeballs attempts to connect to both IPv4 and IPv6 addresses for dual-stack hosts, preferring IPv6 first for timeout milliseconds. - Defaults to CURL_HET_DEFAULT, which is currently 200 milliseconds. - This option accepts any value that can be cast to a valid int. - Available as of PHP 7.3.0 and cURL 7.59.0 + デフォルト値は CURL_HET_DEFAULT (現在は 200 ミリ秒) です。 + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + PHP 7.3.0 以降かつ cURL 7.59.0 以降で利用可能です。 @@ -1108,7 +1122,7 @@ &true; to send an HAProxy PROXY protocol v1 header at the start of the connection. The default action is not to send this header. - Available as of PHP 7.3.0 and cURL 7.60.0. + PHP 7.3.0 以降かつ cURL 7.60.0 以降で利用可能です。 @@ -1121,7 +1135,7 @@ Set to &true; to include the headers in the output sent to the callback defined by CURLOPT_WRITEFUNCTION. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -1157,7 +1171,7 @@ The callback should return the number of bytes written. - Available as of cURL 7.7.2. + cURL 7.7.2 以降で利用可能です。 @@ -1173,7 +1187,7 @@ CURLHEADER_* constants. Defaults to CURLHEADER_SEPARATE as of cURL 7.42.1, and CURLHEADER_UNIFIED prior to that. - Available as of PHP 7.0.7 and cURL 7.37.0. + PHP 7.0.7 以降かつ cURL 7.37.0 以降で利用可能です。 @@ -1187,7 +1201,7 @@ string with HSTS (HTTP Strict Transport Security) cache file name or &null; to allow HSTS without reading from or writing to any file and clear the list of files to read HSTS data from. - Available as of PHP 8.2.0 and cURL 7.74.0. + PHP 8.2.0 以降かつ cURL 7.74.0 以降で利用可能です。 @@ -1200,7 +1214,7 @@ Accepts a bitmask of HSTS (HTTP Strict Transport Security) features defined by the CURLHSTS_* constants. - Available as of PHP 8.2.0 and cURL 7.74.0. + PHP 8.2.0 以降かつ cURL 7.74.0 以降で利用可能です。 @@ -1211,9 +1225,9 @@ - Whether to allow HTTP/0.9 responses. Defaults to &false; as of cURL 7.66.0; - formerly it defaulted to &true;. - Available as of PHP 7.3.15 and 7.4.3, respectively, and cURL 7.64.0. + HTTP/0.9 でのレスポンスを許可するかどうか。cURL 7.66.0 以降のデフォルト値は &false; です。 + それより前のバージョンでは &true; でした。 + PHP 7.3.15 および 7.4.3 以降かつ cURL 7.64.0 以降で利用可能です。 @@ -1225,7 +1239,7 @@ An array of HTTP 200 responses that will be treated as valid responses and not as errors. - Available as of cURL 7.10.3. + cURL 7.10.3 以降で利用可能です。 @@ -1252,7 +1266,7 @@ the one it finds most secure. CURLAUTH_ANYSAFE sets all bits except CURLAUTH_BASIC. cURL will automatically select the one it finds most secure. - Available as of cURL 7.10.6. + cURL 7.10.6 以降で利用可能です。 @@ -1265,7 +1279,7 @@ Set to &true; to reset the HTTP request method to GET. Since GET is the default, this is only necessary if the request method has been changed. - Available as of cURL 7.8.1. + cURL 7.8.1 以降で利用可能です。 @@ -1280,7 +1294,7 @@ array('Content-type: text/plain', 'Content-length: 100') - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -1292,7 +1306,7 @@ &true; to tunnel through a given HTTP proxy. - Available as of cURL 7.3.0. + cURL 7.3.0 以降で利用可能です。 @@ -1304,7 +1318,7 @@ &false; to get the raw HTTP response body. - Available as of cURL 7.16.2. + cURL 7.16.2 以降で利用可能です。 @@ -1319,8 +1333,8 @@ If set to 1, transfer decoding is enabled. cURL does chunked transfer decoding by default unless this option is set to 0. - Defaults to 1. - Available as of cURL 7.16.2. + デフォルト値は 1 です。 + cURL 7.16.2 以降で利用可能です。 @@ -1334,7 +1348,7 @@ Set to one of the CURL_HTTP_VERSION_* constants for cURL to use the specified HTTP version. - Available as of cURL 7.9.1. + cURL 7.9.1 以降で利用可能です。 @@ -1348,8 +1362,8 @@ If set to 1, ignore the Content-Length header in the HTTP response and ignore asking for or relying on it for FTP transfers. - Defaults to 0. - Available as of cURL 7.14.1. + デフォルト値は 0 です。 + cURL 7.14.1 以降で利用可能です。 @@ -1362,7 +1376,7 @@ Accepts a file handle resource to the file that the transfer should be read from when uploading. - Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7. + cURL 7.1.0 以降で利用可能ですが、cURL 7.9.7 以降は非推奨となりました。 Use CURLOPT_READDATA instead. @@ -1378,8 +1392,8 @@ a remote site. Note that using this option will not stop cURL from sending more data, as exactly what is sent depends on CURLOPT_READFUNCTION. - This option accepts any value that can be cast to a valid int. - Available as of cURL 7.1.0. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + cURL 7.1.0 以降で利用可能です。 @@ -1392,7 +1406,7 @@ Set to a string with the name of the outgoing network interface to use. This can be an interface name, an IP address or a host name. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -1408,8 +1422,8 @@ resolve addresses using more than one version of IP. Set to one of the CURL_IPRESOLVE_* constants. - Defaults to CURL_IPRESOLVE_WHATEVER. - Available as of cURL 7.10.8. + デフォルト値は CURL_IPRESOLVE_WHATEVER です。 + cURL 7.10.8 以降で利用可能です。 @@ -1427,7 +1441,7 @@ For the result of the check to be considered a failure, this option should be used in combination with the CURLOPT_SSL_VERIFYPEER option. - Available as of cURL 7.19.0. + cURL 7.19.0 以降で利用可能です。 @@ -1441,7 +1455,7 @@ Pass a string with binary data of a CA SSL certificate in PEM format. If set, an additional check against the peer certificate is performed to verify the issuer is the one associated with the certificate provided by the option. - Available as of PHP 8.1.0 and cURL 7.71.0. + PHP 8.1.0 以降かつ cURL 7.71.0 以降で利用可能です。 @@ -1456,7 +1470,7 @@ The default action would be to stop sending and close the stream or connection. Suitable for manual NTLM authentication. Most applications do not need this option. - Available as of PHP 7.3.0 and cURL 7.51.0. + PHP 7.3.0 以降かつ cURL 7.51.0 以降で利用可能です。 @@ -1470,7 +1484,7 @@ Set to a string with the password required to use the CURLOPT_SSLKEY or CURLOPT_SSH_PRIVATE_KEYFILE private key. Setting this option to &null; disables using a password for these options. - Available as of cURL 7.17.0. + cURL 7.17.0 以降で利用可能です。 @@ -1493,7 +1507,7 @@ private is used. Setting this option to &null; will disable KRB4 security. Currently KRB4 security only works with FTP transactions. - Available as of cURL 7.3.0 and deprecated as of cURL 7.17.0. + cURL 7.3.0 以降で利用可能ですが、cURL 7.17.0 以降は非推奨となりました。 @@ -1515,8 +1529,8 @@ If the string is set but does not match one of these, private is used. Setting this option to &null; will disable kerberos support for FTP. - Defaults to &null;. - Available as of cURL 7.16.4. + デフォルト値は &null; です。 + cURL 7.16.4 以降で利用可能です。 @@ -1528,9 +1542,9 @@ Sets the local port number of the socket used for the connection. - This option accepts any value that can be cast to a valid int. - Defaults to 0. - Available as of cURL 7.15.2. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は 0 です。 + cURL 7.15.2 以降で利用可能です。 @@ -1543,9 +1557,9 @@ The number of attempts cURL makes to find a working local port number, starting with the one set with CURLOPT_LOCALPORT. - This option accepts any value that can be cast to a valid int. - Defaults to 1. - Available as of cURL 7.15.2. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は 1 です。 + cURL 7.15.2 以降で利用可能です。 @@ -1559,7 +1573,7 @@ Can be used to set protocol specific login options, such as the preferred authentication mechanism via AUTH=NTLM or AUTH=*, and should be used in conjunction with the CURLOPT_USERNAME option. - Available as of PHP 7.0.7 and cURL 7.34.0. + PHP 7.0.7 以降かつ cURL 7.34.0 以降で利用可能です。 @@ -1573,8 +1587,8 @@ The transfer speed, in bytes per second, that the transfer should be below during the count of CURLOPT_LOW_SPEED_TIME seconds before PHP considers the transfer too slow and aborts. - This option accepts any value that can be cast to a valid int. - Available as of cURL 7.1.0. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + cURL 7.1.0 以降で利用可能です。 @@ -1588,8 +1602,8 @@ The number of seconds the transfer speed should be below CURLOPT_LOW_SPEED_LIMIT before PHP considers the transfer too slow and aborts. - This option accepts any value that can be cast to a valid int. - Available as of cURL 7.1.0. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + cURL 7.1.0 以降で利用可能です。 @@ -1606,7 +1620,7 @@ (><). If an empty string is used then a pair of brackets are sent by cURL as required by RFC 2554. - Available as of cURL 7.25.0. + cURL 7.25.0 以降で利用可能です。 @@ -1623,7 +1637,7 @@ which if not specified are added automatically. If this parameter is not specified then an empty address is sent to the SMTP server which might cause the email to be rejected. - Available as of cURL 7.20.0. + cURL 7.20.0 以降で利用可能です。 @@ -1641,7 +1655,7 @@ If an angled bracket is not used as the first character, cURL assumes a single email address has been provided and encloses that address within brackets. - Available as of cURL 7.20.0. + cURL 7.20.0 以降で利用可能です。 @@ -1658,9 +1672,9 @@ If all recipients trigger failures and this flag is specified, cURL aborts the SMTP conversation and returns the error received from to the last RCPT TO command. - Replaced by CURLOPT_MAIL_RCPT_ALLOWFAILS as of cURL 8.2.0. - Available as of PHP 8.2.0 and cURL 7.69.0. - Deprecated as of cURL 8.2.0. + cURL 8.2.0 で CURLOPT_MAIL_RCPT_ALLOWFAILS に置き換えられました。 + PHP 8.2.0 以降かつ cURL 7.69.0 以降で利用可能です。 + cURL 8.2.0 以降は非推奨となっています。 @@ -1673,8 +1687,8 @@ The maximum idle time allowed for an existing connection to be considered for reuse. Default maximum age is set to 118 seconds. - This option accepts any value that can be cast to a valid int. - Available as of PHP 8.2.0 and cURL 7.65.0. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + PHP 8.2.0 以降かつ cURL 7.65.0 以降で利用可能です。 @@ -1688,8 +1702,8 @@ The maximum amount of persistent connections that are allowed. When the limit is reached, the oldest one in the cache is closed to prevent increasing the number of open connections. - This option accepts any value that can be cast to a valid int. - Available as of cURL 7.7.0. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + cURL 7.7.0 以降で利用可能です。 @@ -1713,9 +1727,9 @@ CURLOPT_MAXFILESIZE_LARGE should be used. As of cURL 8.4.0, this option also stops ongoing transfers if they reach this threshold. - This option accepts any value that can be cast to a valid int. - Defaults to 0. - Available as of cURL 7.10.8. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + デフォルト値は 0 です。 + cURL 7.10.8 以降で利用可能です。 @@ -1730,8 +1744,8 @@ the transfer will not start and CURLE_FILESIZE_EXCEEDED will be returned. The file size is not always known prior to download, and for such files this option has no effect even if the file transfer ends up being larger than this given limit. - This option accepts any value that can be cast to a valid int. - Available as of PHP 8.2.0 and cURL 7.11.0. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + PHP 8.2.0 以降かつ cURL 7.11.0 以降で利用可能です。 @@ -1746,8 +1760,8 @@ connection to have for it to be considered for reuse. If a connection is found in the cache that is older than this value, it will instead be closed once any in-progress transfers are complete. Default is 0 seconds, meaning the option is disabled and all connections are eligible for reuse. - This option accepts any value that can be cast to a valid int. - Available as of PHP 8.2.0 and cURL 7.80.0. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + PHP 8.2.0 以降かつ cURL 7.80.0 以降で利用可能です。 @@ -1761,7 +1775,7 @@ The maximum amount of HTTP redirections to follow. Use this option alongside CURLOPT_FOLLOWLOCATION. Default value of 20 is set to prevent infinite redirects. Setting to -1 allows inifinite redirects, and 0 refuses all redirects. - Available as of cURL 7.5.0. + cURL 7.5.0 以降で利用可能です。 @@ -1776,8 +1790,8 @@ cumulative average during the transfer, the transfer will pause to keep the average rate less than or equal to the parameter value. Defaults to unlimited speed. - This option accepts any value that can be cast to a valid int. - Available as of cURL 7.15.5. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + cURL 7.15.5 以降で利用可能です。 @@ -1792,8 +1806,8 @@ cumulative average during the transfer, the transfer will pause to keep the average rate less than or equal to the parameter value. Defaults to unlimited speed. - This option accepts any value that can be cast to a valid int. - Available as of cURL 7.15.5. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + cURL 7.15.5 以降で利用可能です。 @@ -1807,7 +1821,7 @@ Set to a bitmask of CURLMIMEOPT_* constants. Currently there is only one available option: CURLMIMEOPT_FORMESCAPE. - Available as of PHP 8.3.0 and cURL 7.81.0. + PHP 8.3.0 以降かつ cURL 7.81.0 以降で利用可能です。 @@ -1821,9 +1835,9 @@ Set to &true; to be completely silent with regards to the cURL functions. Use CURLOPT_RETURNTRANSFER instead. - 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. + cURL 7.1.0 以降で利用可能でしたが、cURL 7.8.0 からは非推奨となっており、 + cURL 7.15.5 を最後に削除されました。 + PHP 7.3.0 で削除されました。 @@ -1837,7 +1851,7 @@ Set to &true; to scan the ~/.netrc file to find a username and password for the remote site that a connection is being established with. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -1852,7 +1866,7 @@ If this option is omitted and CURLOPT_NETRC is set, cURL checks for a .netrc file in the current user's home directory. - Available as of cURL 7.11.0. + cURL 7.11.0 以降で利用可能です。 @@ -1868,7 +1882,7 @@ The only protocols that can use this are sftp://, scp:// and file://. - Available as of cURL 7.16.4. + cURL 7.16.4 以降で利用可能です。 @@ -1884,7 +1898,7 @@ The only protocols that can use this are sftp://, scp:// and file://. - Available as of cURL 7.16.4. + cURL 7.16.4 以降で利用可能です。 @@ -1899,7 +1913,7 @@ For HTTP(S), cURL makes a HEAD request. For most other protocols, cURL is not asking for the body data at all. Changing this to &false; will result in body data being included in the output. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -1917,7 +1931,7 @@ changed for debugging purposes. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -1938,7 +1952,7 @@ Setting this option to an empty string enables the proxy for all hostnames. Since cURL 7.86.0, IP addresses set with this option can be provided using CIDR notation. - Available as of cURL 7.19.4. + cURL 7.19.4 以降で利用可能です。 @@ -1952,7 +1966,7 @@ &true; to ignore any cURL function that causes a signal to be sent to the PHP process. This is turned on by default in multi-threaded SAPIs so timeout options can still be used. - Available as of cURL 7.10. + cURL 7.10 以降で利用可能です。 @@ -1997,9 +2011,9 @@ The callback should return a string containing the password. - 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. + cURL 7.4.2 以降で利用可能でしたが、cURL 7.11.1 からは非推奨となっており、 + cURL 7.15.5 を最後に削除されました。 + PHP 7.3.0 で削除されました。 @@ -2011,7 +2025,7 @@ Set to a string with the password to use in authentication. - Available as of cURL 7.19.1. + cURL 7.19.1 以降で利用可能です。 @@ -2026,7 +2040,7 @@ Defaults to &false;, which squashes sequences of /../ or /./ that may exist in the URL's path part which is supposed to be removed according to RFC 3986 section 5.2.4. - Available as of PHP 7.0.7 and cURL 7.42.0. + PHP 7.0.7 以降かつ cURL 7.42.0 以降で利用可能です。 @@ -2042,7 +2056,7 @@ in a PEM or DER file format. The string can also be any number of base64 encoded sha256 hashes preceded by sha256// and separated by ;. - Available as of PHP 7.0.7 and cURL 7.39.0. + PHP 7.0.7 以降かつ cURL 7.39.0 以降で利用可能です。 @@ -2056,7 +2070,7 @@ Set to &true; to wait for an existing connection to confirm whether it can do multiplexing and use it if it can before creating and using a new connection. - Available as of PHP 7.0.7 and cURL 7.43.0. + PHP 7.0.7 以降かつ cURL 7.43.0 以降で利用可能です。 @@ -2069,7 +2083,7 @@ An int with an alternative port number to connect to instead of the one specified in the URL or the default port for the used protocol. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2082,8 +2096,8 @@ Set to &true; to do a HTTP POST request. This request uses the application/x-www-form-urlencoded header. - Defaults to &false;. - Available as of cURL 7.1.0. + デフォルト値は &false; です。 + cURL 7.1.0 以降で利用可能です。 @@ -2103,7 +2117,7 @@ multipart/form-data. Files can be sent using CURLFile or CURLStringFile, in which case value must be an array. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2116,7 +2130,7 @@ An array of FTP command strings to execute on the server after the FTP request has been performed. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2132,7 +2146,7 @@ if the HTTP POST method should be maintained when CURLOPT_FOLLOWLOCATION is set and a specific type of redirect occurs. - Available as of cURL 7.19.1. + cURL 7.19.1 以降で利用可能です。 @@ -2155,7 +2169,7 @@ to the end of the host name. The proxy's port number may optionally be specified with the separate option CURLOPT_PROXYPORT. Defaults to using port 1080 for proxies if a port is not specified. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2170,7 +2184,7 @@ after the transfer type is set. These commands are not performed when a directory listing is performed, only for file transfers. - Available as of cURL 7.9.5. + cURL 7.9.5 以降で利用可能です。 @@ -2187,7 +2201,7 @@ curl_getinfo. cURL does nothing with this data. When using a cURL multi handle, this private data is typically a unique key to identify a standard cURL handle. - Available as of cURL 7.10.3. + cURL 7.10.3 以降で利用可能です。 @@ -2257,7 +2271,7 @@ option is set to &false;. - Available as of cURL 7.1.0 and deprecated as of cURL 7.32.0. + cURL 7.1.0 以降で利用可能ですが、cURL 7.32.0 以降は非推奨となりました。 Use CURLOPT_XFERINFOFUNCTION instead. @@ -2273,7 +2287,7 @@ If used, this bitmask limits what protocols cURL may use in the transfer. Defaults to CURLPROTO_ALL, ie. cURL will accept all protocols it supports. See also CURLOPT_REDIR_PROTOCOLS. - Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0. + cURL 7.19.4 以降で利用可能ですが、cURL 7.85.0 以降は非推奨となりました。 @@ -2323,7 +2337,7 @@ WS WSS . - Available as of PHP 8.3.0 and cURL 7.85.0. + PHP 8.3.0 以降かつ cURL 7.85.0 以降で利用可能です。 @@ -2337,7 +2351,7 @@ A string with the HTTP proxy to tunnel requests through. This should be the hostname, the dotted numerical IP address or a numerical IPv6 address written within [brackets]. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2353,8 +2367,8 @@ to use for the proxy connection. For proxy authentication, only CURLAUTH_BASIC and CURLAUTH_NTLM are currently supported. - Defaults to CURLAUTH_BASIC. - Available as of cURL 7.10.7. + デフォルト値は CURLAUTH_BASIC です。 + cURL 7.10.7 以降で利用可能です。 @@ -2366,7 +2380,7 @@ An array of custom HTTP header strings to pass to proxies. - Available as of PHP 7.0.7 and cURL 7.37.0. + PHP 7.0.7 以降かつ cURL 7.37.0 以降で利用可能です。 @@ -2378,7 +2392,7 @@ Set a string with the password to be used for authentication with the proxy. - Available as of cURL 7.19.1. + cURL 7.19.1 以降で利用可能です。 @@ -2393,7 +2407,7 @@ This port number can also be set in CURLOPT_PROXY. Setting this to zero makes cURL use the default proxy port number or the port number specified in the proxy URL string. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2406,8 +2420,8 @@ Sets the type of the proxy to one of the CURLPROXY_* constants. - Defaults to CURLPROXY_HTTP. - Available as of cURL 7.10. + デフォルト値は CURLPROXY_HTTP です。 + cURL 7.10 以降で利用可能です。 @@ -2419,7 +2433,7 @@ Set a string with the username to be used for authentication with the proxy. - Available as of cURL 7.19.1. + cURL 7.19.1 以降で利用可能です。 @@ -2433,7 +2447,7 @@ A string with a username and password formatted as [username]:[password] to use for the connection to the proxy. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2450,7 +2464,7 @@ This option is for connecting to an HTTPS proxy, not an HTTPS server. Defaults set to the system path where cURL's cacert bundle is assumed to be stored. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2465,7 +2479,7 @@ This option is for connecting to an HTTPS proxy, not an HTTPS server. Defaults set to the system path where cURL's cacert bundle is assumed to be stored. - Available as of PHP 8.2.0 and cURL 7.77.0. + PHP 8.2.0 以降かつ cURL 7.77.0 以降で利用可能です。 @@ -2478,7 +2492,7 @@ A string with the directory holding multiple CA certificates to verify the HTTPS proxy with. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2493,7 +2507,7 @@ with the concatenation of CRL (Certificate Revocation List) in PEM format to use in the certificate validation that occurs during the SSL exchange. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2505,7 +2519,7 @@ Proxy issuer SSL certificate filename string. - Available as of PHP 8.1.0 and cURL 7.71.0. + PHP 8.1.0 以降かつ cURL 7.71.0 以降で利用可能です。 @@ -2517,7 +2531,7 @@ A string with the proxy issuer SSL certificate. - Available as of PHP 8.1.0 and cURL 7.71.0. + PHP 8.1.0 以降かつ cURL 7.71.0 以降で利用可能です。 @@ -2533,7 +2547,7 @@ A passphrase is not needed to load a certificate but one is needed to load a private key. This option is for connecting to an HTTPS proxy, not an HTTPS server. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2550,7 +2564,7 @@ or DER file format. The string can also be any number of base64 encoded sha256 hashes preceded by sha256// and separated by ;. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2562,7 +2576,7 @@ A string with the proxy authentication service name. - Available as of PHP 7.0.7, cURL 7.43.0 (for HTTP proxies) and cURL 7.49.0 (for SOCKS5 proxies). + PHP 7.0.7 以降かつ、HTTP プロキシを使う場合は cURL 7.43.0 以降、SOCKS5 プロキシを使う場合は cURL 7.49.0 以降で利用可能です。 @@ -2581,7 +2595,7 @@ If a file from the current directory is to be used, it must be prefixed with ./ in order to avoid confusion with a nickname. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2597,7 +2611,7 @@ 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. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2609,7 +2623,7 @@ A string with the SSL proxy client certificate. - Available as of PHP 8.1.0 and cURL 7.71.0. + PHP 8.1.0 以降かつ cURL 7.71.0 以降で利用可能です。 @@ -2626,7 +2640,7 @@ CURLOPT_PROXY_SSLKEYTYPE. (iOS and Mac OS X only) This option is ignored if cURL was built against Secure Transport. Available if built with TLS enabled. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2644,7 +2658,7 @@ DER ENG . - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2656,7 +2670,7 @@ A string with the private key for connecting to the HTTPS proxy. - Available as of PHP 8.1.0 and cURL 7.71.0. + PHP 8.1.0 以降かつ cURL 7.71.0 以降で利用可能です。 @@ -2670,7 +2684,7 @@ Set the preferred HTTPS proxy TLS version to one of the CURL_SSLVERSION_* constants. - Defaults to CURL_SSLVERSION_DEFAULT. + デフォルト値は CURL_SSLVERSION_DEFAULT です。 It is better to not set this option and leave the default @@ -2678,7 +2692,7 @@ which will attempt to figure out the remote SSL protocol version. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2694,7 +2708,7 @@ When used with OpenSSL commas and spaces are also acceptable as separators, and !, - and + can be used as operators. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2707,7 +2721,7 @@ Set proxy SSL behavior options, which is a bitmask of the CURLSSLOPT_* constants. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2723,10 +2737,10 @@ Use that ability with caution! Set to 1 in cURL 7.28.0 and earlier as a debug option. Set to 1 in cURL 7.28.1 to 7.65.3 CURLE_BAD_FUNCTION_ARGUMENT is returned. - As of cURL 7.66.0 1 and 2 is treated as the same value. - Defaults to 2. + cURL 7.66.0 以降では 1 は 2 と同じ値として扱われます。 + デフォルト値は 2 です。 In production environments the value of this option should be kept at 2. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2744,7 +2758,7 @@ CURLOPT_CAPATH option. When set to &false;, the peer certificate verification succeeds regardless. &true; by default. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2759,7 +2773,7 @@ This option is currently used only when cURL is built to use OpenSSL 1.1.1 or later. When using a different SSL backend the TLS 1.3 cipher suites can be set with the CURLOPT_PROXY_SSL_CIPHER_LIST option. - Available as of PHP 7.3.0 and cURL 7.61.0. + PHP 7.3.0 以降かつ cURL 7.61.0 以降で利用可能です。 @@ -2773,7 +2787,7 @@ A string with the password to use for the TLS authentication method specified with the CURLOPT_PROXY_TLSAUTH_TYPE option. Requires that the CURLOPT_PROXY_TLSAUTH_USERNAME option to also be set. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2794,7 +2808,7 @@ CURLOPT_PROXY_TLSAUTH_PASSWORD options must also be set. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2808,7 +2822,7 @@ The username to use for the HTTPS proxy TLS authentication method specified with the CURLOPT_PROXY_TLSAUTH_TYPE option. Requires that the CURLOPT_PROXY_TLSAUTH_PASSWORD option to also be set. - Available as of PHP 7.3.0 and cURL 7.52.0. + PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 @@ -2825,8 +2839,8 @@ Without this setting or it being set to 0, CURLOPT_TRANSFERTEXT has no effect when doing FTP via a proxy. - Defaults to 0. - Available as of cURL 7.18.0. + デフォルト値は 0 です。 + cURL 7.18.0 以降で利用可能です。 @@ -2840,7 +2854,7 @@ &true; to HTTP PUT a file. The file to PUT must be set with CURLOPT_READDATA and CURLOPT_INFILESIZE. - Available as of cURL 7.1.0 and deprecated as of cURL 7.12.1. + cURL 7.1.0 以降で利用可能ですが、cURL 7.12.1 以降は非推奨となりました。 @@ -2855,7 +2869,7 @@ when recovering from a timeout. This allows for a swift termination of the cURL process at the expense of a possible leak of associated resources. - Available as of PHP 8.3.0 and cURL 7.87.0. + PHP 8.3.0 以降かつ cURL 7.87.0 以降で利用可能です。 @@ -2867,7 +2881,7 @@ An array of FTP command strings to execute on the server prior to the FTP request. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2879,7 +2893,7 @@ A string with a filename to be used to seed the random number generator for SSL. - Available as of cURL 7.7.0 and deprecated as of cURL 7.84.0. + cURL 7.7.0 以降で利用可能ですが、cURL 7.84.0 以降は非推奨となりました。 @@ -2894,7 +2908,7 @@ also support several intervals, separated with commas in the format X-Y,N-M. Set to &null; to disable requesting a byte range. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2907,7 +2921,7 @@ Sets a file pointer resource that will be used by the file read function set with CURLOPT_READFUNCTION. - Available as of cURL 7.9.7. + cURL 7.9.7 以降で利用可能です。 @@ -2956,7 +2970,7 @@ with a length equal or smaller than the amount of data requested, typically by reading it from the passed stream resource. It should return an empty string to signal EOF. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -2976,7 +2990,7 @@ except for FILE and SCP. Prior to cURL 7.19.4, cURL would unconditionally follow to all supported protocols. See also CURLOPT_PROTOCOLS for protocol constant values. - Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0. + cURL 7.19.4 以降で利用可能ですが、cURL 7.85.0 以降は非推奨となりました。 @@ -3034,7 +3048,7 @@ WS WSS . - Available as of PHP 8.3.0 and cURL 7.85.0. + PHP 8.3.0 以降かつ cURL 7.85.0 以降で利用可能です。 @@ -3047,7 +3061,7 @@ A string with the contents of the Referer: header to be used in a HTTP request. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -3060,7 +3074,7 @@ A string to use in the upcoming request instead of the path as extracted from the URL. - Available as of PHP 7.3.0 and cURL 7.55.0. + PHP 7.3.0 以降かつ cURL 7.55.0 以降で利用可能です。 @@ -3079,7 +3093,7 @@ "example2.com:443:127.0.0.2", ) - Available as of cURL 7.21.3. + cURL 7.21.3 以降で利用可能です。 @@ -3091,8 +3105,8 @@ The offset, in bytes, to resume a transfer from. - This option accepts any value that can be cast to a valid int. - Available as of cURL 7.1.0. + このオプションは、有効な int にキャストできる任意の値を受け付けます。 + cURL 7.1.0 以降で利用可能です。 @@ -3119,8 +3133,8 @@ Set an int with the CSEQ number to issue for the next RTSP request. Useful if the application is resuming a previously broken connection. The CSEQ increments from this new number henceforth. - Defaults to 0. - Available as of cURL 7.20.0. + デフォルト値は 0 です。 + cURL 7.20.0 以降で利用可能です。 @@ -3134,7 +3148,7 @@ Sets the kind of RTSP request to make. Must be one of the CURL_RTSPREQ_* constants. - Available as of cURL 7.20.0. + cURL 7.20.0 以降で利用可能です。 @@ -3148,8 +3162,8 @@ Set an int with the CSEQ number to expect for the next RTSP Server to Client request. This feature (listening for Server requests) is unimplemented. - Defaults to 0. - Available as of cURL 7.20.0. + デフォルト値は 0 です。 + cURL 7.20.0 以降で利用可能です。 @@ -3167,7 +3181,7 @@ If set to &null;, cURL automatically sets the ID the first time the server sets it in a response. Defaults to &null; - Available as of cURL 7.20.0. + cURL 7.20.0 以降で利用可能です。 @@ -3185,7 +3199,7 @@ indicates what URL to send to the server in the request header while the CURLOPT_URL indicates where to make the connection to. - Available as of cURL 7.20.0. + cURL 7.20.0 以降で利用可能です。 @@ -3197,7 +3211,7 @@ Set the Transport: header for this RTSP session. - Available as of cURL 7.20.0. + cURL 7.20.0 以降で利用可能です。 @@ -3227,7 +3241,7 @@ authentication mechanism where it is optional. When not specified, only the authentication identity (authcid) as specified by the username will be sent to the server, along with the password. The server will derive the authzid from the authcid when not provided, which it will then use internally. - Available as of PHP 8.2.0 and cURL 7.66.0. + PHP 8.2.0 以降かつ cURL 7.66.0 以降で利用可能です。 @@ -3239,7 +3253,7 @@ &true; to enable sending the initial response in the first packet. - Available as of PHP 7.0.7 and cURL 7.31.0. + PHP 7.0.7 以降かつ cURL 7.31.0 以降で利用可能です。 @@ -3251,7 +3265,7 @@ A string with the authentication service name. - Available as of PHP 7.0.7 and cURL 7.43.0. + PHP 7.0.7 以降かつ cURL 7.43.0 以降で利用可能です。 @@ -3264,7 +3278,7 @@ A result of curl_share_init. Makes the cURL handle to use the data from the shared handle. - Available as of cURL 7.10. + cURL 7.10 以降で利用可能です。 @@ -3283,9 +3297,9 @@ . When more than one method is set, cURL will poll the server to see what methods it supports and pick the best one. - Defaults to CURLAUTH_BASIC|CURLAUTH_GSSAPI. + デフォルト値は CURLAUTH_BASIC|CURLAUTH_GSSAPI です。 Set the actual username and password with the CURLOPT_PROXYUSERPWD option. - Available as of PHP 7.3.0 and cURL 7.55.0. + PHP 7.3.0 以降かつ cURL 7.55.0 以降で利用可能です。 @@ -3299,7 +3313,7 @@ Set to 1 to enable and 0 to disable the unprotected exchange of the protection mode negotiation as part of the GSSAPI negotiation. - Available as of cURL 7.19.4. + cURL 7.19.4 以降で利用可能です。 @@ -3311,8 +3325,8 @@ Set a string holding the name of the SOCKS5 service. - Defaults to rcmd. - Available as of cURL 7.19.4 and deprecated as of cURL 7.49.0. + デフォルト値は rcmd です。 + cURL 7.19.4 以降で利用可能ですが、cURL 7.49.0 以降は非推奨となりました。 Use CURLOPT_PROXY_SERVICE_NAME instead. @@ -3333,8 +3347,8 @@ CURLSSH_AUTH_AGENT CURLSSH_AUTH_ANY . - Defaults to CURLSSH_AUTH_ANY. - Available as of cURL 7.16.1. + デフォルト値は CURLSSH_AUTH_ANY です。 + cURL 7.16.1 以降で利用可能です。 @@ -3347,8 +3361,8 @@ &true; to enable, &false; to disable built-in SSH compression. Note that the server can disregard this request. - Defaults to &false;. - Available as of PHP 7.3.0 and cURL 7.56.0. + デフォルト値は &false; です。 + PHP 7.3.0 以降かつ cURL 7.56.0 以降で利用可能です。 @@ -3403,7 +3417,7 @@ This callback overrides CURLOPT_SSH_KNOWNHOSTS. - Available as of PHP 8.3.0 and cURL 7.84.0. + PHP 8.3.0 以降かつ cURL 7.84.0 以降で利用可能です。 @@ -3418,7 +3432,7 @@ MD5 checksum of the remote host's public key, and cURL will reject the connection to the host unless the md5sums match. This option is only for SCP and SFTP transfers. - Available as of cURL 7.17.1. + cURL 7.17.1 以降で利用可能です。 @@ -3432,7 +3446,7 @@ A string with the base64-encoded SHA256 hash of the remote host's public key. The transfer will fail if the given hash does not match the hash the remote host provides. - Available as of PHP 8.2.0 and cURL 7.80.0. + PHP 8.2.0 以降かつ cURL 7.80.0 以降で利用可能です。 @@ -3445,7 +3459,7 @@ Set to the filename of the known_host file to use which should use the OpenSSH file format as supported by libssh2. - Available as of cURL 7.19.6. + cURL 7.19.6 以降で利用可能です。 @@ -3461,7 +3475,7 @@ and just id_dsa in the current directory if HOME is not set. If the file is password-protected, set the password with CURLOPT_KEYPASSWD. - Available as of cURL 7.16.1. + cURL 7.16.1 以降で利用可能です。 @@ -3475,7 +3489,7 @@ The file name for a public key. If not used, cURL defaults to $HOME/.ssh/id_dsa.pub if the HOME environment variable is set, and just id_dsa.pub in the current directory if HOME is not set. - Available as of cURL 7.16.1. + cURL 7.16.1 以降で利用可能です。 @@ -3487,7 +3501,7 @@ The name of a file containing a PEM formatted certificate. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -3500,7 +3514,7 @@ The password required to use the CURLOPT_SSLCERT certificate. - Available as of cURL 7.1.0 and deprecated as of cURL 7.17.0. + cURL 7.1.0 以降で利用可能ですが、cURL 7.17.0 以降は非推奨となりました。 @@ -3511,16 +3525,16 @@ - A string with the format of the certificate. Supported formats are: + 証明書のフォーマットを string で指定します。サポートされているフォーマット： PEM DER ENG P12 . - P12 (for PKCS#12-encoded files) is available as of OpenSSL 0.9.3. - Defaults to PEM. - Available as of cURL 7.9.3. + P12 (PKCS#12 でエンコードされたファイル用) は OpenSSL 0.9.3 以降で利用可能です。 + デフォルト値は PEM です。 + cURL 7.9.3 以降で利用可能です。 @@ -3531,8 +3545,8 @@ - A string with the SSL client certificate. - Available as of PHP 8.1.0 and cURL 7.71.0. + SSL のクライアント証明書を string で指定します。 + PHP 8.1.0 以降かつ cURL 7.71.0 以降で利用可能です。 @@ -3545,7 +3559,7 @@ The string identifier for the crypto engine of the private SSL key specified in CURLOPT_SSLKEY. - Available as of cURL 7.9.3. + cURL 7.9.3 以降で利用可能です。 @@ -3558,7 +3572,7 @@ The string identifier for the crypto engine used for asymmetric crypto operations. - Available as of cURL 7.9.3. + cURL 7.9.3 以降で利用可能です。 @@ -3570,7 +3584,7 @@ The name of a file containing a private SSL key. - Available as of cURL 7.9.3. + cURL 7.9.3 以降で利用可能です。 @@ -3589,7 +3603,7 @@ the PHP script it is contained within safe. - Available as of cURL 7.9.3 and deprecated as of cURL 7.17.0. + cURL 7.9.3 以降で利用可能ですが、cURL 7.17.0 以降は非推奨となりました。 @@ -3607,8 +3621,8 @@ DER ENG . - Defaults to PEM. - Available as of cURL 7.9.3. + デフォルト値は PEM です。 + cURL 7.9.3 以降で利用可能です。 @@ -3620,7 +3634,7 @@ A string private key for client cert. - Available as of PHP 8.1.0 and cURL 7.71.0. + PHP 8.1.0 以降かつ cURL 7.71.0 以降で利用可能です。 @@ -3644,8 +3658,8 @@ vulnerabilities in SSLv2 and SSLv3. - Defaults to CURL_SSLVERSION_DEFAULT. - Available as of cURL 7.1.0. + デフォルト値は CURL_SSLVERSION_DEFAULT です。 + cURL 7.1.0 以降で利用可能です。 @@ -3658,7 +3672,7 @@ A colon-separated string of ciphers to use for the TLS 1.2 (1.1, 1.0) connection. - Available as of cURL 7.9. + cURL 7.9 以降で利用可能です。 @@ -3673,7 +3687,7 @@ X25519:P-521 is a valid list of two elliptic curves. This option defines the client's key exchange algorithms in the SSL handshake, if the SSL backend cURL is built to use supports it. - Available as of PHP 8.2.0 and cURL 7.73.0. + PHP 8.2.0 以降かつ cURL 7.73.0 以降で利用可能です。 @@ -3687,7 +3701,7 @@ &false; to disable ALPN in the SSL handshake (if the SSL backend cURL is built to use supports it), which can be used to negotiate http2. - Available as of PHP 7.0.7 and cURL 7.36.0. + PHP 7.0.7 以降かつ cURL 7.36.0 以降で利用可能です。 @@ -3701,7 +3715,7 @@ &false; to disable NPN in the SSL handshake (if the SSL backend cURL is built to use supports it), which can be used to negotiate http2. - Available as of PHP 7.0.7 and cURL 7.36.0, and deprecated as of cURL 7.86.0. + PHP 7.0.7 以降かつ cURL 7.36.0 以降で利用可能ですが、cURL 7.86.0 以降は非推奨となりました。 @@ -3715,7 +3729,7 @@ &true; to enable and &false; to disable TLS false start which is a mode where a TLS client starts sending application data before verifying the server's Finished message. - Available as of PHP 7.0.7 and cURL 7.42.0. + PHP 7.0.7 以降かつ cURL 7.42.0 以降で利用可能です。 @@ -3729,7 +3743,7 @@ Set SSL behavior options, which is a bitmask of the CURLSSLOPT_* constants. Defaults to none of the bits being set. - Available as of PHP 7.0.7. and cURL 7.25.0. + PHP 7.0.7. 以降かつ cURL 7.25.0 以降で利用可能です。 @@ -3743,7 +3757,7 @@ Set to 0 to disable and 1 to enable SSL session-ID caching. By default all transfers are done using the cache enabled. - Available as of cURL 7.16.0. + cURL 7.16.0 以降で利用可能です。 @@ -3760,7 +3774,7 @@ 1 should not be used. In production environments the value of this option should be kept at 2 (default value). Support for value 1 removed in cURL 7.28.1. - Available as of cURL 7.8.1. + cURL 7.8.1 以降で利用可能です。 @@ -3776,9 +3790,9 @@ specified with the CURLOPT_CAINFO option or a certificate directory can be specified with the CURLOPT_CAPATH option. - Defaults to &true; as of cURL 7.10. + cURL 7.10 以降のデフォルト値は &true; です。 Default bundle of CA certificates installed as of cURL 7.10. - Available as of cURL 7.4.2. + cURL 7.4.2 以降で利用可能です。 @@ -3790,7 +3804,7 @@ &true; to enable and &false; to disable verification of the certificate's status. - Available as of PHP 7.0.7 and cURL 7.41.0. + PHP 7.0.7 以降かつ cURL 7.41.0 以降で利用可能です。 @@ -3804,7 +3818,7 @@ Accepts a file handle resource pointing to an alternative location to output errors to instead of STDERR. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -3816,7 +3830,7 @@ Set the numerical stream weight (a number between 1 and 256). - Available as of PHP 7.0.7 and cURL 7.46.0. + PHP 7.0.7 以降かつ cURL 7.46.0 以降で利用可能です。 @@ -3830,8 +3844,8 @@ &true; to suppress proxy CONNECT response headers from the user callback functions CURLOPT_HEADERFUNCTION and CURLOPT_WRITEFUNCTION, when CURLOPT_HTTPPROXYTUNNEL is used and a CONNECT request is made. - Defaults to &false;. - Available as of PHP 7.3.0 and cURL 7.54.0. + デフォルト値は &false; です。 + PHP 7.3.0 以降かつ cURL 7.54.0 以降で利用可能です。 @@ -3843,7 +3857,7 @@ &true; to enable and &false; to disable TCP Fast Open. - Available as of PHP 7.0.7 and cURL 7.49.0. + PHP 7.0.7 以降かつ cURL 7.49.0 以降で利用可能です。 @@ -3860,7 +3874,7 @@ supports them. If set to 0 (default) keepalive probes are disabled. The maximum number of probes can be set with the CURLOPT_TCP_KEEPCNT option. - Available as of cURL 7.25.0. + cURL 7.25.0 以降で利用可能です。 @@ -3875,7 +3889,7 @@ idle before sending keepalive probes, if CURLOPT_TCP_KEEPALIVE is enabled. Not all operating systems support this option. The default is 60. - Available as of cURL 7.25.0. + cURL 7.25.0 以降で利用可能です。 @@ -3890,7 +3904,7 @@ keepalive probes, if CURLOPT_TCP_KEEPALIVE is enabled. Not all operating systems support this option. The default is 60. - Available as of cURL 7.25.0. + cURL 7.25.0 以降で利用可能です。 @@ -3903,7 +3917,7 @@ Sets the maximum number of TCP keep-alive probes. The default is 9. - Available as of PHP 8.4.0 and cURL 8.9.0. + PHP 8.4.0 以降かつ cURL 8.9.0 以降で利用可能です。 @@ -3916,8 +3930,8 @@ &true; to disable TCP's Nagle algorithm, which tries to minimize the number of small packets on the network. - Defaults to &true;. - Available as of cURL 7.11.2. + デフォルト値は &true; です。 + cURL 7.11.2 以降で利用可能です。 @@ -3932,7 +3946,7 @@ The variables should be in the format >option=value<. cURL supports the options TTYPE, XDISPLOC and NEW_ENV. - Available as of cURL 7.7.0. + cURL 7.7.0 以降で利用可能です。 @@ -3950,7 +3964,7 @@ If the server does not return an option acknowledgment or returns an option acknowledgment with no block size, the default of 512 bytes is used. - Available as of cURL 7.19.4. + cURL 7.19.4 以降で利用可能です。 @@ -3962,8 +3976,8 @@ &true; to not send TFTP options requests. - Defaults to &false;. - Available as of PHP 7.0.7 and cURL 7.48.0. + デフォルト値は &false; です。 + PHP 7.0.7 以降かつ cURL 7.48.0 以降で利用可能です。 @@ -3986,7 +4000,7 @@ CURL_TIMECOND_NONE is the default. Prior to cURL 7.46.0 the default was CURL_TIMECOND_IFMODSINCE. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -3999,7 +4013,7 @@ The maximum number of seconds to allow cURL functions to execute. Defaults to 0, meaning that functions never time out during transfer. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -4016,7 +4030,7 @@ portion of the connect will still use full-second resolution for timeouts with a minimum timeout allowed of one second. Defaults to 0, meaning that functions never time out during transfer. - Available as of cURL 7.16.2. + cURL 7.16.2 以降で利用可能です。 @@ -4029,8 +4043,8 @@ The time in seconds since January 1st, 1970. The time will be used by CURLOPT_TIMECONDITION. - Defaults to 0. - Available as of cURL 7.1.0. + デフォルト値は 0 です。 + cURL 7.1.0 以降で利用可能です。 @@ -4046,7 +4060,7 @@ The difference between this option and CURLOPT_TIMEVALUE is the type of the argument. On systems where 'long' is only 32 bit wide, this option has to be used to set dates beyond the year 2038. - Available as of PHP 7.3.0 and cURL 7.59.0. + PHP 7.3.0 以降かつ cURL 7.59.0 以降で利用可能です。 @@ -4062,7 +4076,7 @@ This option is currently used only when cURL is built to use OpenSSL 1.1.1 or later. When using a different SSL backend the TLS 1.3 cipher suites can be set with the CURLOPT_SSL_CIPHER_LIST option. - Available as of PHP 7.3.0 and cURL 7.61.0. + PHP 7.3.0 以降かつ cURL 7.61.0 以降で利用可能です。 @@ -4077,7 +4091,7 @@ with the CURLOPT_TLSAUTH_TYPE option. Requires that the CURLOPT_TLSAUTH_USERNAME option also be set. This feature relies on TLS SRP which does not work with TLS 1.3. - Available as of cURL 7.21.4. + cURL 7.21.4 以降で利用可能です。 @@ -4091,7 +4105,7 @@ Set a string with the method of the TLS authentication. Supported method is SRP (TLS Secure Remote Password authentication). - Available as of cURL 7.21.4. + cURL 7.21.4 以降で利用可能です。 @@ -4107,7 +4121,7 @@ Requires that the CURLOPT_TLSAUTH_PASSWORD option also be set. This feature relies on TLS SRP which does not work with TLS 1.3. - Available as of cURL 7.21.4. + cURL 7.21.4 以降で利用可能です。 @@ -4123,8 +4137,8 @@ HTTP request. If the server responds with a compressed Transfer Encoding, cURL will automatically uncompress it on reception. - Defaults to 0. - Available as of cURL 7.21.6. + デフォルト値は 0 です。 + cURL 7.21.6 以降で利用可能です。 @@ -4139,8 +4153,8 @@ For LDAP, it retrieves data in plain text instead of HTML. On Windows systems, it will not set STDOUT to binary mode. - Defaults to &false;. - Available as of cURL 7.1.1. + デフォルト値は &false; です。 + cURL 7.1.1 以降で利用可能です。 @@ -4154,8 +4168,8 @@ Enables the use of Unix domain sockets as connection endpoint and sets the path to the given string. Set to &null; to disable. - Defaults to &null;. - Available as of PHP 7.0.7 and cURL 7.40.0. + デフォルト値は &null; です。 + PHP 7.0.7 以降かつ cURL 7.40.0 以降で利用可能です。 @@ -4170,8 +4184,8 @@ when following locations (using CURLOPT_FOLLOWLOCATION), even when the hostname has changed. - Defaults to &false;. - Available as of cURL 7.10.4. + デフォルト値は &false; です。 + cURL 7.10.4 以降で利用可能です。 @@ -4188,7 +4202,7 @@ interval is exceeded, an HTTP/2 PING frame is sent on the connection. Defaults to CURL_UPKEEP_INTERVAL_DEFAULT which is currently 60 seconds. - Available as of PHP 8.2.0 and cURL 7.62.0. + PHP 8.2.0 以降かつ cURL 7.62.0 以降で利用可能です。 @@ -4200,8 +4214,8 @@ &true; to prepare for and perform an upload. - Defaults to &false;. - Available as of cURL 7.1.0. + デフォルト値は &false; です。 + cURL 7.1.0 以降で利用可能です。 @@ -4215,7 +4229,7 @@ Preferred buffer size in bytes for the cURL upload buffer. The upload buffer size by default is 64 kilobytes. The maximum buffer size allowed to be set is 2 megabytes. The minimum buffer size allowed to be set is 16 kilobytes. - Available as of PHP 8.2.0 and cURL 7.62.0. + PHP 8.2.0 以降かつ cURL 7.62.0 以降で利用可能です。 @@ -4228,7 +4242,7 @@ The URL to fetch. This can also be set when initializing a session with curl_init. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -4245,7 +4259,7 @@ and get "upgraded" to SSL using the STARTTLS command. Set to one of the CURLUSESSL_* constants. - Available as of cURL 7.17.0. + cURL 7.17.0 以降で利用可能です。 @@ -4258,7 +4272,7 @@ The contents of the User-Agent: header to be used in a HTTP request. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -4270,7 +4284,7 @@ The user name to use in authentication. - Available as of cURL 7.19.1. + cURL 7.19.1 以降で利用可能です。 @@ -4298,8 +4312,8 @@ &true; to output verbose information. Writes output to STDERR, or the file specified using CURLOPT_STDERR. - Defaults to &false;. - Available as of cURL 7.1.0. + デフォルト値は &false; です。 + cURL 7.1.0 以降で利用可能です。 @@ -4316,7 +4330,7 @@ CURLOPT_URL option, using an fnmatch-like pattern (Shell Pattern Matching) in the last part of URL (filename). - Available as of cURL 7.21.0. + cURL 7.21.0 以降で利用可能です。 @@ -4354,7 +4368,7 @@ The data must be saved by the callback and the callback must return the exact number of bytes written or the transfer will be aborted with an error. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -4366,7 +4380,7 @@ Accepts a file handle resource to the file that the header part of the transfer is written to. - Available as of cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -4379,8 +4393,8 @@ Accepts a bitmask setting WebSocket behavior options. The only available option is CURLWS_RAW_MODE. - Defaults to 0. - Available as of PHP 8.3.0 and cURL 7.86.0. + デフォルト値は 0 です。 + PHP 8.3.0 以降かつ cURL 7.86.0 以降で利用可能です。 @@ -4444,7 +4458,7 @@ Return 1 to abort the transfer and set a CURLE_ABORTED_BY_CALLBACK error. - Available as of PHP 8.2.0 and cURL 7.32.0. + PHP 8.2.0 以降かつ cURL 7.32.0 以降で利用可能です。 @@ -4460,7 +4474,7 @@ SCP, SMTP, or a POP3 server. This option replaces the existing CURLOPT_FTP_RESPONSE_TIMEOUT option which is deprecated in cURL 7.85.0. - Available as of PHP 8.4.0. + PHP 8.4.0 以降で利用可能です。 @@ -4473,8 +4487,8 @@ Specifies the OAuth 2.0 access token. Set to &null; to disable. - Defaults to &null;. - Available as of PHP 7.0.7 and cURL 7.33.0. + デフォルト値は &null; です。 + PHP 7.0.7 以降かつ cURL 7.33.0 以降で利用可能です。 @@ -4548,7 +4562,7 @@ Return CURL_PREREQFUNC_OK to allow the request, or CURL_PREREQFUNC_ABORT to abort the transfer. - Available as of PHP 8.4.0 and cURL 7.80.0. + PHP 8.4.0 以降かつ cURL 7.80.0 以降で利用可能です。 @@ -4559,7 +4573,7 @@ - Available as of PHP 8.4.0. + PHP 8.4.0 以降で利用可能です。 This option requires CURLOPT_VERBOSE option enabled. A callable to replace the standard cURL verbose output. This callback gets called during various stages of the request with verbose debug information. From 7c8bed72332f4af86e94e02c5daee8ec0107f558 Mon Sep 17 00:00:00 2001 From: nsfisis Date: Sat, 24 May 2025 01:51:28 +0900 Subject: [PATCH 4/7] =?UTF-8?q?wip:=20=E9=80=B2=E6=8D=97=E7=8E=87=2022=20%?= =?UTF-8?q?=20=E3=81=8F=E3=82=89=E3=81=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/curl/constants_curl_setopt.xml | 208 +++++++++++------------ 1 file changed, 97 insertions(+), 111 deletions(-) diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index 421f96ab31..0c5842517c 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -27,9 +27,9 @@ - HTTP リクエストの中で送られる Accept-Encoding: ヘッダの内容を + HTTP リクエストの中で送られる Accept-Encoding: ヘッダーの内容を string で指定します。 - &null; をセットすると、Accept-Encoding: ヘッダの送信を無効にします。 + &null; をセットすると、Accept-Encoding: ヘッダーの送信を無効にします。 デフォルト値は &null; です。 cURL 7.21.6 以降で利用可能です。 @@ -44,7 +44,7 @@ !!! "active FTP connection" アクティブな FTP 接続を使用している場合に、 - cURL がサーバーからの接続を待機する最大ミリ秒数。 + cURL がサーバーからの接続を待機する最大ミリ秒数を指定します。 このオプションは、有効な int にキャストできる任意の値を受け付けます。 デフォルト値は 60000 ミリ秒です。 cURL 7.24.0 以降で利用可能です。 @@ -121,7 +121,7 @@ &true; を指定すると、リクエストが Location: のリダイレクトによるものである場合、 - 自動的に Referer: ヘッダを設定します。 + 自動的に Referer: ヘッダーを設定します。 デフォルト値は 0 です。 cURL 7.1.0 以降で利用可能です。 @@ -134,7 +134,7 @@ - AWS V4 署名認証を HTTP(S) ヘッダに string として指定します。 + AWS V4 署名認証を HTTP(S) ヘッダーに string として指定します。 このオプションは、CURLOPT_HTTPAUTH で設定された 他の認証方法を上書きします。これと他の認証方法を組み合わせることはできません。 PHP 8.2.0 以降かつ cURL 7.75.0 以降で利用可能です。 @@ -160,7 +160,7 @@ - 各読込で使用するバッファサイズ。 + 各読込で使用するバッファサイズを設定します。 ただし、必ずしも指定した値が使われるとは限りません。 このオプションは、有効な int にキャストできる任意の値を受け付けます。 デフォルト値は CURL_MAX_WRITE_SIZE (現在は 16kB) です。 @@ -175,7 +175,6 @@ - !!! "one or more" !!! CURLOPT_CAINFO_BLOB との差は？ 相手を検証するための証明書を格納したファイル名を string で指定します。 このオプションは、CURLOPT_SSL_VERIFYPEER と組み合わせて用いた場合のみ意味を持ちます。 @@ -191,7 +190,6 @@ - !!! "one or more" !!! CURLOPT_CAINFO との差は？ 相手を検証するための証明書を格納した PEM ファイル名を string で指定します。 このオプションは CURLOPT_CAINFO を上書きします。 @@ -206,7 +204,7 @@ - 複数の CA 証明書を格納したディレクトリを string で指定します。 + CA 証明書を格納したディレクトリを string で指定します。 CURLOPT_SSL_VERIFYPEER と一緒に使用してください。 cURL 7.9.8 以降で利用可能です。 @@ -219,9 +217,8 @@ - !!! - Sets the maximum time in seconds any in memory cached CA certificate store - may be kept and reused for new connections. + CA 証明書ストアのインメモリキャッシュが保持され、新しい接続に再利用される + 最大時間を秒単位で指定します。 このオプションは、有効な int にキャストできる任意の値を受け付けます。 デフォルト値は 86400 (24 時間) です。 PHP 8.3.0 以降かつ cURL 7.87.0 以降で利用可能です。 @@ -235,10 +232,9 @@ - !!! - &true; to output SSL certification information to STDERR - on secure transfers. - Requires CURLOPT_VERBOSE to be on to have an effect. + &true; に設定すると、暗号化された通信の際に + SSL 認証情報を STDERR へ出力します。 + CURLOPT_VERBOSE を有効にしている場合にのみ効果があります。 デフォルト値は &false; です。 cURL 7.19.1 以降で利用可能です。 @@ -251,7 +247,7 @@ - 接続するまでの最大待機秒数。 + 接続するまでの最大待機秒数を指定します。 0 を指定するといつまでも待機します。 このオプションは、有効な int にキャストできる任意の値を受け付けます。 デフォルト値は 300 です。 @@ -266,9 +262,9 @@ - 接続するまでの最大待機ミリ秒数。 + 接続するまでの最大待機ミリ秒数を指定します。 0 を指定するといつまでも待機します。 - !!! + !!! "standard system name resolver" をどう訳すか考える If cURL is built to use the standard system name resolver, that portion of the connect will still use full-second resolution for timeouts with a minimum timeout allowed of one second. @@ -285,10 +281,9 @@ - !!! - &true; tells the library to perform all the required proxy authentication - and connection setup, but no data transfer. This option is implemented for - HTTP, SMTP and POP3. + &true; を指定すると、必要なプロキシの認証をおこなって接続を確立するだけで、 + データ転送をおこなわなくなります。このオプションは + HTTP、SMTP、POP3 で実装されています。 デフォルト値は &false; です。 cURL 7.15.2 以降で利用可能です。 @@ -301,10 +296,9 @@ - !!! - Connect to a specific host and port instead of the URL's host and port. - Accepts an array of strings with the format - HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. + URL のホストとポートの代わりに、指定したホストとポートに接続します。 + HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT の形式の + string を array で受け付けます。 PHP 7.0.7 以降かつ cURL 7.49.0 以降で利用可能です。 @@ -316,10 +310,8 @@ - !!! - A string with the contents of the Cookie: header to be used in the HTTP request. - Note that multiple cookies are separated with a semicolon followed - by a space (e.g., fruit=apple; colour=red). + HTTP リクエストの中で使われる Cookie: ヘッダーの内容を string で指定します。 + 複数のクッキーを指定する場合はセミコロンとスペースで区切ります (例: fruit=apple; colour=red)。 cURL 7.1.0 以降で利用可能です。 @@ -331,11 +323,10 @@ - !!! - A string with the name of the file containing the cookie data. - The cookie file can be in Netscape format, or just plain HTTP-style headers dumped into a file. - If the name is an empty string, no cookies are loaded, but cookie - handling is still enabled. + クッキーデータを格納したファイル名を string で指定します。 + クッキーファイルは Netscape 形式か、通常の HTTP スタイルのヘッダーをそのままファイルにダンプしたものです。 + ファイル名が空の string の場合、クッキーは読み込まれませんが、クッキーの処理は + おこなわれます。 cURL 7.1.0 以降で利用可能です。 @@ -347,16 +338,15 @@ - !!! - A string with the name of a file to save all internal cookies to when - the handle's destructor is called. + cURL が保持しているすべてのクッキーを保存するファイル名を string で指定します。 + 書込はcURL ハンドルが破棄されたときにおこなわれます。 cURL 7.9.0 以降で利用可能です。 - As of PHP 8.0.0, curl_close is a no-op - and does not destroy the handle. - If cookies need to be written prior to the handle being automatically - destroyed, call unset on the handle. + PHP 8.0.0 以降、curl_close は + 何もしなくなり、ハンドルを破棄 しなく なりました。 + ハンドラが自動的に破棄されるよりも前にクッキーを書き出す必要がある場合、 + ハンドルに対して unset を呼び出してください。 @@ -369,26 +359,26 @@ - A cookie string (i.e. a single line in Netscape/Mozilla format, or a regular - HTTP-style Set-Cookie header) adds that single cookie to the internal cookie store. + string で指定されたクッキーを内部のクッキーストアに追加します。 + この文字列は Nescape/Mozilla 形式の単一行、または通常の HTTP スタイルの Set-Cookie ヘッダーです。 ALL - erases all cookies held in memory + はメモリ上に保持されているすべてのクッキーを削除し SESS - erases all session cookies held in memory + はメモリ上に保持されているすべてのセッションクッキーを削除し FLUSH - writes all known cookies to the file specified by CURLOPT_COOKIEJAR + は CURLOPT_COOKIEJAR で指定されたファイルにすべてのクッキーを書き出し RELOAD - loads all cookies from the files specified by CURLOPT_COOKIEFILE + は CURLOPT_COOKIEFILE で指定されたファイルからすべてのクッキーを読み込みます - . + 。 cURL 7.14.1 以降で利用可能です。 @@ -417,8 +407,8 @@ - &true; to convert Unix newlines to CRLF newlines - on transfers. + &true; を指定すると、Unix の改行コードを CRLF 改行コードに変換して + 送ります。 cURL 7.1.0 以降で利用可能です。 @@ -464,7 +454,7 @@ i.e. Do not enter a whole HTTP request line here. For instance, entering GET /index.html HTTP/1.0\r\n\r\n would be incorrect. - This option accepts a string or &null;. + このオプションは string ないし &null; を受け取ります。 cURL 7.1.0 以降で利用可能です。 @@ -482,7 +472,7 @@ - A string with the default protocol to use if the URL is missing a scheme name. + URL がスキーム名を持たない場合に使用するデフォルトのプロトコルを string で指定します。 PHP 7.0.7 以降かつ cURL 7.45.0 以降で利用可能です。 @@ -514,8 +504,8 @@ - &true; to not allow URLs that include a username. - Usernames are allowed by default. + &true; を指定すると、URL にユーザー名を含められなくなります。 + デフォルトではユーザー名を含められます。 PHP 7.3.0 以降かつ cURL 7.61.0 以降で利用可能です。 @@ -527,8 +517,8 @@ - The number of seconds to keep DNS entries in memory. This - option is set to 120 (2 minutes) by default. + DNS のエントリーをメモリ上に保持する秒数を指定します。 + このオプションは、デフォルトで 120 (2分) に設定されています。 このオプションは、有効な int にキャストできる任意の値を受け付けます。 cURL 7.9.3 以降で利用可能です。 @@ -542,8 +532,8 @@ Set the name of the network interface that the DNS resolver should bind to. - This must be an interface name (not an address). - This option accepts a string or &null;. + アドレスではなくインターフェース名を指定する必要があります。 + このオプションは string ないし &null; を受け取ります。 PHP 7.0.7 以降かつ cURL 7.33.0 以降で利用可能です。 @@ -557,7 +547,7 @@ Set the local IPv4 address that the resolver should bind to. The argument should contain a single numerical IPv4 address. - This option accepts a string or &null;. + このオプションは string ないし &null; を受け取ります。 PHP 7.0.7 以降かつ cURL 7.33.0 以降で利用可能です。 @@ -571,7 +561,7 @@ Set the local IPv6 address that the resolver should bind to. The argument should contain a single numerical IPv6 address. - This option accepts a string or &null;. + このオプションは string ないし &null; を受け取ります。 PHP 7.0.7 以降かつ cURL 7.33.0 以降で利用可能です。 @@ -583,9 +573,9 @@ - Pass a string with a comma-separated list of DNS servers to be used - instead of the system default - (e.g.: 192.168.1.100,192.168.1.101:8080). + システムのデフォルト DNS サーバーの代わりに使用する DNS サーバーのリストを + コンマ区切りの string で指定します + (例: 192.168.1.100,192.168.1.101:8080)。 cURL 7.24.0 以降で利用可能です。 @@ -666,7 +656,7 @@ Provides the DNS-over-HTTPS URL. - This option accepts a string or &null;. + このオプションは string ないし &null; を受け取ります。 PHP 8.1.0 以降かつ cURL 7.62.0 以降で利用可能です。 @@ -711,7 +701,7 @@ - The timeout for Expect: 100-continue responses in milliseconds. + Expect: 100-continue レスポンスのタイムアウトをミリ秒で指定します。 デフォルト値は 1000 ミリ秒です。 このオプションは、有効な int にキャストできる任意の値を受け付けます。 PHP 7.0.7 以降かつ cURL 7.36.0 以降で利用可能です。 @@ -725,9 +715,8 @@ - &true; to fail verbosely if the HTTP code returned - is greater than or equal to 400. The default behavior is to return - the page normally, ignoring the code. + &true; を指定すると、返された HTTP コードが 400 以上だったときにエラー情報と共に失敗するようになります。 + デフォルトの挙動では、コードを無視して通常どおりページを返します。 cURL 7.1.0 以降で利用可能です。 @@ -739,9 +728,8 @@ - Accepts a file handle resource - to the file that the transfer should be written to. - The default is STDOUT (the browser window). + 転送データを書き込むファイルのファイルハンドル resource を受け取ります。 + デフォルトは STDOUT (ブラウザウィンドウ) です。 cURL 7.1.0 以降で利用可能ですが、cURL 7.9.7 以降は非推奨となりました。 @@ -753,10 +741,9 @@ - Set to &true; to attempt to retrieve the modification - date of the remote document. This value can be retrieved using - the CURLINFO_FILETIME option with - curl_getinfo. + &true; を指定すると、リモートのドキュメントの更新日時を取得しようとします。 + その値は、curl_getinfo に + CURLINFO_FILETIME オプションを使うことで取得できます。 cURL 7.5.0 以降で利用可能です。 @@ -817,11 +804,10 @@ - Set to &true; to follow any Location: header that the server sends as - part of the HTTP header. - See also CURLOPT_MAXREDIRS. - This constant is not available when open_basedir - is enabled. + &true; を指定すると、サーバーから HTTP ヘッダーの一部として送られた Location: ヘッダーを + 追跡するようになります。 + CURLOPT_MAXREDIRS も合わせてご覧ください。 + この定数は open_basedir が有効になっていると利用できません。 cURL 7.1.0 以降で利用可能です。 @@ -903,7 +889,7 @@ string may be a plain IP address, a hostname, a network interface name (under Unix), or just a plain - to use the system's default IP address. - This option accepts a string or &null;. + このオプションは string ないし &null; を受け取ります。 cURL 7.1.0 以降で利用可能です。 @@ -985,7 +971,7 @@ - FTP サーバからのレスポンスを待機するタイムアウト秒数。 + FTP サーバーからのレスポンスを待機するタイムアウト秒数を指定します。 このオプションは CURLOPT_TIMEOUT を上書きします。 このオプションは、有効な int にキャストできる任意の値を受け付けます。 このオプション名は PHP 8.4.0 で CURLOPT_SERVER_RESPONSE_TIMEOUT @@ -1133,8 +1119,8 @@ - Set to &true; to include the headers in the output sent to the callback - defined by CURLOPT_WRITEFUNCTION. + &true; を指定すると、CURLOPT_WRITEFUNCTION で定義されたコールバックへと渡される出力に + ヘッダーが含まれるようになります。 cURL 7.1.0 以降で利用可能です。 @@ -1146,7 +1132,7 @@ - A callable with the following signature: + 以下のシグニチャに従う callable を指定します。 intcallback resourcecurlHandle @@ -1157,7 +1143,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -1165,12 +1151,12 @@ headerData - The header data which must be written by the callback. + このコールバックが書き込まなければならないヘッダーデータ。 - The callback should return the number of bytes written. + このコールバックは、書き込んだバイト数を返すべきです。 cURL 7.7.2 以降で利用可能です。 @@ -1225,7 +1211,7 @@ - HTTP/0.9 でのレスポンスを許可するかどうか。cURL 7.66.0 以降のデフォルト値は &false; です。 + HTTP/0.9 でのレスポンスを許可するかどうかを指定します。cURL 7.66.0 以降のデフォルト値は &false; です。 それより前のバージョンでは &true; でした。 PHP 7.3.15 および 7.4.3 以降かつ cURL 7.64.0 以降で利用可能です。 @@ -1277,8 +1263,8 @@ - Set to &true; to reset the HTTP request method to GET. Since GET is the default, this is only necessary if the request - method has been changed. + &true; を指定すると、HTTP リクエストのメソッドを GET にリセットします。 + デフォルトは GET のため、これが必要なのはリクエストメソッドが変更されていた場合のみです。 cURL 7.8.1 以降で利用可能です。 @@ -1290,7 +1276,7 @@ - An array of HTTP header fields to set, in the format + HTTP ヘッダーフィールドの array を指定します。各要素の形式は以下のとおりです。 array('Content-type: text/plain', 'Content-length: 100') @@ -1317,7 +1303,7 @@ - &false; to get the raw HTTP response body. + &false; を指定すると、生の HTTP レスポンスボディを取得できます。 cURL 7.16.2 以降で利用可能です。 @@ -1329,10 +1315,11 @@ - If set to 0, transfer decoding is disabled. - If set to 1, transfer decoding is enabled. - cURL does chunked transfer decoding by default - unless this option is set to 0. + !!! "chunked transfer decoding" の訳 + 0 を指定すると転送時のデコード処理を無効にします。 + 1 を指定すると転送時のデコード処理を有効にします。 + このオプションを 0 に設定しない限り、 + cURL は "chunked transfer decoding" をデフォルトでおこないます。 デフォルト値は 1 です。 cURL 7.16.2 以降で利用可能です。 @@ -1345,9 +1332,8 @@ - Set to one of the - CURL_HTTP_VERSION_* constants - for cURL to use the specified HTTP version. + CURL_HTTP_VERSION_* 定数のいずれかを指定することで、 + cURL に指定した HTTP バージョンを使わせることができます。 cURL 7.9.1 以降で利用可能です。 @@ -1541,7 +1527,7 @@ - Sets the local port number of the socket used for the connection. + 接続に用いるソケットのローカルポート番号を指定します。 このオプションは、有効な int にキャストできる任意の値を受け付けます。 デフォルト値は 0 です。 cURL 7.15.2 以降で利用可能です。 @@ -1772,9 +1758,9 @@ - The maximum amount of HTTP redirections to follow. Use this option alongside CURLOPT_FOLLOWLOCATION. - Default value of 20 is set to prevent infinite redirects. - Setting to -1 allows inifinite redirects, and 0 refuses all redirects. + HTTP リダイレクトの最大回数を指定します。CURLOPT_FOLLOWLOCATION と合わせて使用してください。 + デフォルト値の 20 は、無限リダイレクトを防ぐために設定されています。 + -1 を指定すると何度でもリダイレクトするようになります。0 を指定すると一切リダイレクトしなくなります。 cURL 7.5.0 以降で利用可能です。 @@ -4283,7 +4269,7 @@ - The user name to use in authentication. + 認証に用いるユーザー名を指定します。 cURL 7.19.1 以降で利用可能です。 @@ -4298,7 +4284,7 @@ A username and password formatted as [username]:[password] to use for the connection. - Available as cURL 7.1.0. + cURL 7.1.0 以降で利用可能です。 @@ -4309,9 +4295,9 @@ - &true; to output verbose information. Writes - output to STDERR, or the file specified using - CURLOPT_STDERR. + &true; を指定すると、詳細な情報を出力します。 + 出力は STDERR か、 + CURLOPT_STDERR で指定されたファイルへと書き込まれます。 デフォルト値は &false; です。 cURL 7.1.0 以降で利用可能です。 From 7e52b9f6c923e4f9c7fda89007cfc22d53115418 Mon Sep 17 00:00:00 2001 From: nsfisis Date: Sun, 22 Jun 2025 20:16:46 +0900 Subject: [PATCH 5/7] =?UTF-8?q?wip:=20=E9=80=B2=E6=8D=97=E7=8E=87=2038=20%?= =?UTF-8?q?=20=E3=81=8F=E3=82=89=E3=81=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/curl/constants_curl_setopt.xml | 107 +++++++++++------------ 1 file changed, 52 insertions(+), 55 deletions(-) diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index 0c5842517c..abf26a556e 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -339,7 +339,7 @@ cURL が保持しているすべてのクッキーを保存するファイル名を string で指定します。 - 書込はcURL ハンドルが破棄されたときにおこなわれます。 + 書込は cURL ハンドルが破棄されたときにおこなわれます。 cURL 7.9.0 以降で利用可能です。 @@ -755,8 +755,8 @@ - Pass a callable that will be used for wildcard matching. - The signature of the callback should be: + ワイルドカードのマッチングに用いられる callable を渡します。 + コールバックのシグニチャは以下のとおりです。 intcallback resourcecurlHandle @@ -768,7 +768,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -776,7 +776,7 @@ pattern - The wildcard pattern. + ワイルドカードパターン。 @@ -784,15 +784,14 @@ string - The string to run the wildcard pattern matching on. + ワイルドカードパターンとマッチしているか判定する string。 - The callback should return - CURL_FNMATCHFUNC_MATCH if pattern matches the string, - CURL_FNMATCHFUNC_NOMATCH if not - or CURL_FNMATCHFUNC_FAIL if an error occurred. + この関数は、パターンが string とマッチしていれば CURL_FNMATCHFUNC_MATCH を、 + していなければ CURL_FNMATCHFUNC_NOMATCH を、 + エラー時は CURL_FNMATCHFUNC_FAIL を返さなければなりません。 cURL 7.21.0 以降で利用可能です。 @@ -819,8 +818,8 @@ - Set to &true; to force the connection to explicitly - close when it has finished processing, and not be pooled for reuse. + &true; を指定すると、処理が完了したとき明示的に接続を閉じ、 + 再利用のためにプールしないようになります。 cURL 7.7.0 以降で利用可能です。 @@ -832,8 +831,8 @@ - Set to &true; to force the use of a new connection - instead of a cached one. + &true; を指定すると、キャッシュされた接続を使う代わりに + 必ず新しい接続を用います。 cURL 7.7.0 以降で利用可能です。 @@ -845,8 +844,8 @@ - Set to &true; to append to the remote file instead of - overwriting it. + &true; を指定すると、リモートのファイルを上書きするのではなく、 + 追記するようになります。 cURL 7.1.0 以降で利用可能ですが、cURL 7.16.4 以降は非推奨となりました。 @@ -1132,7 +1131,7 @@ - 以下のシグニチャに従う callable を指定します。 + 以下のシグニチャの callable を指定します。 intcallback resourcecurlHandle @@ -1156,7 +1155,7 @@ - このコールバックは、書き込んだバイト数を返すべきです。 + このコールバックは、書き込んだバイト数を返さなければなりません。 cURL 7.7.2 以降で利用可能です。 @@ -1236,7 +1235,7 @@ - A bitmask of HTTP authentication method(s) to use. The options are: + 使用する HTTP 認証方法のビットマスクです。選択肢は以下のとおりです。 CURLAUTH_BASIC CURLAUTH_DIGEST @@ -1245,13 +1244,13 @@ CURLAUTH_AWS_SIGV4 CURLAUTH_ANY CURLAUTH_ANYSAFE - . - If more than one method is used, cURL will poll the server to see - what methods it supports and pick the best one. - CURLAUTH_ANY sets all bits. cURL will automatically select - the one it finds most secure. - CURLAUTH_ANYSAFE sets all bits except CURLAUTH_BASIC. - cURL will automatically select the one it finds most secure. + + 2つ以上の認証方法を指定した場合、cURL はサーバがどの認証方法をサポートしているか + 問い合わせ、最適なものを選択します。 + CURLAUTH_ANY は全ビットをオンにします。cURL は自動的に + 最も安全だと思われるものを選択します。 + CURLAUTH_ANYSAFE は、CURLAUTH_BASIC を除いた全ビットをオンにします。 + cURL は自動的に最も安全だと思われるものを選択します。 cURL 7.10.6 以降で利用可能です。 @@ -1390,8 +1389,8 @@ - Set to a string with the name of the outgoing network interface to use. - This can be an interface name, an IP address or a host name. + 使用する送信ネットワークインターフェースの名前を string で指定します。 + インターフェース名、IP アドレス、ホスト名のいずれかが指定できます。 cURL 7.1.0 以降で利用可能です。 @@ -1963,7 +1962,7 @@ - A callable with the following signature: + 以下のシグニチャの callable を指定します。 stringcallback resourcecurlHandle @@ -1975,7 +1974,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -2198,7 +2197,7 @@ - A callable with the following signature: + 以下のシグニチャの callable を指定します。 intcallback resourcecurlHandle @@ -2212,7 +2211,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -2918,7 +2917,7 @@ - A callable with the following signature: + 以下のシグニチャの callable を指定します。 stringcallback resourcecurlHandle @@ -2930,7 +2929,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -3360,7 +3359,7 @@ A callable that will be called when SSH host key verification is needed. - The callback must have the following signature: + このコールバックは、以下のシグニチャである必要があります。 intcallback resourcecurlHandle @@ -3373,7 +3372,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -4226,8 +4225,8 @@ - The URL to fetch. This can also be set when initializing a - session with curl_init. + 取得する URL を指定します。この設定は curl_init で + セッションを初期化する際にも指定できます。 cURL 7.1.0 以降で利用可能です。 @@ -4256,8 +4255,7 @@ - The contents of the User-Agent: header to be - used in a HTTP request. + HTTP リクエストで使われる User-Agent: ヘッダーの内容を指定します。 cURL 7.1.0 以降で利用可能です。 @@ -4281,9 +4279,8 @@ - A username and password formatted as - [username]:[password] to use for the - connection. + [username]:[password] の形で + 接続に用いるユーザー名とパスワードを指定します。 cURL 7.1.0 以降で利用可能です。 @@ -4327,7 +4324,7 @@ - A callable with the following signature: + 以下のシグニチャの callable を指定します。 intcallback resourcecurlHandle @@ -4338,7 +4335,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -4391,7 +4388,7 @@ - A callable with the following signature: + 以下のシグニチャの callable を指定します。 intcallback resourcecurlHandle @@ -4405,7 +4402,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -4455,11 +4452,11 @@ - A timeout in seconds cURL will wait for a response from an - FTP, SFTP, IMAP, - SCP, SMTP, or a POP3 server. - This option replaces the existing CURLOPT_FTP_RESPONSE_TIMEOUT - option which is deprecated in cURL 7.85.0. + サーバからのレスポンスを cURL が待機するタイムアウト秒数を指定します。この設定が使われるのは、 + FTP サーバ、SFTP サーバ、IMAP サーバ、 + SCP サーバ、SMTP サーバ、POP3 サーバです。 + このオプションは、cURL 7.85.0 で非推奨となった + CURLOPT_FTP_RESPONSE_TIMEOUT を置き換えます。 PHP 8.4.0 以降で利用可能です。 @@ -4503,7 +4500,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 @@ -4563,7 +4560,7 @@ This option requires CURLOPT_VERBOSE option enabled. A callable to replace the standard cURL verbose output. This callback gets called during various stages of the request with verbose debug information. - The callback should match the following signature: + このコールバックは、以下のシグニチャである必要があります。 voidcallback CurlHandlecurlHandle @@ -4575,7 +4572,7 @@ curlHandle - The cURL handle. + cURL ハンドル。 From 0853e3a504eb0328900451138532b96c22b3fc4f Mon Sep 17 00:00:00 2001 From: nsfisis Date: Tue, 24 Jun 2025 20:46:06 +0900 Subject: [PATCH 6/7] =?UTF-8?q?wip:=20=E9=80=B2=E6=8D=97=E7=8E=87=2040=20%?= =?UTF-8?q?=20=E3=81=8F=E3=82=89=E3=81=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/curl/constants_curl_setopt.xml | 59 ++++++++++++------------ 1 file changed, 29 insertions(+), 30 deletions(-) diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index abf26a556e..e4d93e7bd3 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -1982,7 +1982,7 @@ passwordPrompt - A password prompt. + パスワードプロンプト。 @@ -1990,12 +1990,12 @@ maximumPasswordLength - The maximum length of the password. + パスワードの最大長。 - The callback should return a string containing the password. + このコールバックは、パスワードが入った string を返さなければなりません。 cURL 7.4.2 以降で利用可能でしたが、cURL 7.11.1 からは非推奨となっており、 cURL 7.15.5 を最後に削除されました。 PHP 7.3.0 で削除されました。 @@ -2219,7 +2219,7 @@ bytesToDownload - The total number of bytes expected to be downloaded in this transfer. + この転送でダウンロードされようとしている総バイト数。 @@ -2227,7 +2227,7 @@ bytesDownloaded - The number of bytes downloaded so far. + これまでにダウンロードされたバイト数。 @@ -2235,7 +2235,7 @@ bytesToUpload - The total number of bytes expected to be uploaded in this transfer. + この転送でアップロードされようとしている総バイト数。 @@ -2243,21 +2243,21 @@ bytesUploaded - The number of bytes uploaded so far. + これまでにアップロードされたバイト数。 - The callback should return an int with a non-zero value to abort the transfer - and set a CURLE_ABORTED_BY_CALLBACK error. + 転送を中断し、CURLE_ABORTED_BY_CALLBACK エラーをセットするには、 + このコールバックから非ゼロの int を返してください。 - The callback is only called when the CURLOPT_NOPROGRESS - option is set to &false;. + このコールバックが呼ばれるのは、CURLOPT_NOPROGRESS オプションが + &false; に設定されている場合のみです。 cURL 7.1.0 以降で利用可能ですが、cURL 7.32.0 以降は非推奨となりました。 - Use CURLOPT_XFERINFOFUNCTION instead. + 代わりに CURLOPT_XFERINFOFUNCTION を用いてください。 @@ -2937,8 +2937,8 @@ streamResource - Stream resource provided to cURL through the option - CURLOPT_READDATA. + CURLOPT_READDATA オプションを通して + cURL へと渡されたストリーム resource。 @@ -2946,15 +2946,15 @@ maxAmountOfDataToRead - The maximum amount of data to be read. + 読み出すべきデータの最大長。 - The callback should return a string - with a length equal or smaller than the amount of data requested, - typically by reading it from the passed stream resource. It should - return an empty string to signal EOF. + このコールバックは、要求されたデータ長以下の string を + 返さなければなりません。 + 典型的には、渡されたストリーム resource からデータを読み出して返します。 + EOF を伝えるためには空の string を返してください。 cURL 7.1.0 以降で利用可能です。 @@ -4343,14 +4343,13 @@ data - The data to be written. + 書き込むべきデータ。 - The data must be saved by the callback - and the callback must return the exact number of bytes written - or the transfer will be aborted with an error. + このコールバックは、データを保存して書き込んだバイト数を返さなければなりません。 + そうしないなら、転送はエラーで中止されます (訳注: 一度にすべてのデータを書き込む必要があり、部分的な書き込みはできません。つまり、返り値は渡されたデータ長と一致しなければなりません)。 cURL 7.1.0 以降で利用可能です。 @@ -4410,7 +4409,7 @@ bytesToDownload - The total number of bytes expected to be downloaded in this transfer. + この転送でダウンロードされようとしている総バイト数。 @@ -4418,7 +4417,7 @@ bytesDownloaded - The number of bytes downloaded so far. + これまでにダウンロードされたバイト数。 @@ -4426,7 +4425,7 @@ bytesToUpload - The total number of bytes expected to be uploaded in this transfer. + この転送でアップロードされようとしている総バイト数。 @@ -4434,13 +4433,13 @@ bytesUploaded - The number of bytes uploaded so far. + これまでにアップロードされたバイト数。 - Return 1 to abort the transfer - and set a CURLE_ABORTED_BY_CALLBACK error. + 転送を中断し、CURLE_ABORTED_BY_CALLBACK エラーをセットするには、 + 1 を返してください。 PHP 8.2.0 以降かつ cURL 7.32.0 以降で利用可能です。 @@ -4557,7 +4556,7 @@ PHP 8.4.0 以降で利用可能です。 - This option requires CURLOPT_VERBOSE option enabled. + このオプションを利用するには CURLOPT_VERBOSE オプションを有効にする必要があります。 A callable to replace the standard cURL verbose output. This callback gets called during various stages of the request with verbose debug information. このコールバックは、以下のシグニチャである必要があります。 From 601cf161e2d230eab6db75563f48d0ad33ef0f05 Mon Sep 17 00:00:00 2001 From: nsfisis Date: Tue, 24 Jun 2025 23:33:58 +0900 Subject: [PATCH 7/7] =?UTF-8?q?wip:=20=E9=80=B2=E6=8D=97=E7=8E=87=2043=20%?= =?UTF-8?q?=20=E3=81=8F=E3=82=89=E3=81=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/curl/constants_curl_setopt.xml | 80 ++++++++++++------------ 1 file changed, 40 insertions(+), 40 deletions(-) diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index e4d93e7bd3..82ad660b1e 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -1,6 +1,6 @@ - + <function>curl_setopt</function> @@ -1245,7 +1245,7 @@ CURLAUTH_ANY CURLAUTH_ANYSAFE - 2つ以上の認証方法を指定した場合、cURL はサーバがどの認証方法をサポートしているか + 2つ以上の認証方法を指定した場合、cURL はサーバーがどの認証方法をサポートしているか 問い合わせ、最適なものを選択します。 CURLAUTH_ANY は全ビットをオンにします。cURL は自動的に 最も安全だと思われるものを選択します。 @@ -3358,7 +3358,7 @@ - A callable that will be called when SSH host key verification is needed. + SSH ホストキーの検証が必要になった場合に呼ばれる callable を指定します。 このコールバックは、以下のシグニチャである必要があります。 intcallback @@ -3380,7 +3380,7 @@ keyType - One of the CURLKHTYPE_* key types. + CURLKHTYPE_* のうちいずれかのキーの種類。 @@ -3388,7 +3388,7 @@ key - The key to check. + チェックするキー。 @@ -3396,12 +3396,12 @@ keyLength - The length of the key in bytes. + キーのバイト長。 - This callback overrides CURLOPT_SSH_KNOWNHOSTS. + このコールバックは CURLOPT_SSH_KNOWNHOSTS を上書きします。 PHP 8.3.0 以降かつ cURL 7.84.0 以降で利用可能です。 @@ -4451,9 +4451,9 @@ - サーバからのレスポンスを cURL が待機するタイムアウト秒数を指定します。この設定が使われるのは、 - FTP サーバ、SFTP サーバ、IMAP サーバ、 - SCP サーバ、SMTP サーバ、POP3 サーバです。 + サーバーからのレスポンスを cURL が待機するタイムアウト秒数を指定します。この設定が使われるのは、 + FTP サーバー、SFTP サーバー、IMAP サーバー、 + SCP サーバー、SMTP サーバー、POP3 サーバーです。 このオプションは、cURL 7.85.0 で非推奨となった CURLOPT_FTP_RESPONSE_TIMEOUT を置き換えます。 PHP 8.4.0 以降で利用可能です。 @@ -4481,11 +4481,11 @@ - A callable with the following signature that gets called after the - connection is established, but before the request payload (for example, the - GET/POST/DELETE request of an HTTP connection) is sent, and can be used to abort - or allow the connection depending on the source and destination IP address and - port numbers: + 以下のシグニチャを持つ callable を指定します。 + このコールバックは、接続が確立され、リクエストペイロード + (例えば、HTTP 接続における GET/POST/DELETE リクエスト) が送られる前に呼ばれます。 + 送信元/送信先 IP アドレスやポート番号に応じて接続を中止したり許可したりするのに + 用いることができます。 intcallback CurlHandlecurlHandle @@ -4507,9 +4507,9 @@ destination_ip - The primary IP of the remote server established with this connection. - For FTP, this is the IP for the control connection. - IPv6 addresses are represented without surrounding brackets. + この接続で確立されたリモートサーバーのプライマリー IP アドレス。 + FTP の場合は、制御用接続の IP アドレスになります。 + IPv6 のアドレスは、角括弧で囲わずに表現されます。 @@ -4517,8 +4517,8 @@ local_ip - The originating IP for this connection. - IPv6 addresses are represented without surrounding brackets. + この接続の送信元 IP アドレス。 + IPv6 のアドレスは、角括弧で囲わずに表現されます。 @@ -4526,9 +4526,9 @@ destination_port - The primary port number on the remote server established with this connection. - For FTP, this is the port for the control connection. - This can be a TCP or a UDP port number depending on the protocol. + この接続で確立されたリモートサーバーのプライマリーポート番号。 + FTP の場合は、制御用接続のポート番号になります。 + プロトコルに応じて、TCP または UDP のポート番号になります。 @@ -4536,14 +4536,14 @@ local_port - The originating port number for this connection. - This can be a TCP or a UDP port number depending on the protocol. + この接続の送信元ポート番号。 + プロトコルに応じて、TCP または UDP のポート番号になります。 - Return CURL_PREREQFUNC_OK to allow the request, or - CURL_PREREQFUNC_ABORT to abort the transfer. + リクエストを許可する場合は CURL_PREREQFUNC_OK を、 + 転送を中止する場合は CURL_PREREQFUNC_ABORT を返してください。 PHP 8.4.0 以降かつ cURL 7.80.0 以降で利用可能です。 @@ -4557,9 +4557,9 @@ PHP 8.4.0 以降で利用可能です。 このオプションを利用するには CURLOPT_VERBOSE オプションを有効にする必要があります。 - A callable to replace the standard cURL verbose output. - This callback gets called during various stages of the request with verbose debug information. - このコールバックは、以下のシグニチャである必要があります。 + cURL 標準の詳細出力を置き換える callable を指定します。 + このコールバックは、リクエストのさまざまな段階で詳細なデバッグ情報とともに呼び出されます。 + これは以下のシグニチャである必要があります。 voidcallback CurlHandlecurlHandle @@ -4579,7 +4579,7 @@ type - One of the following constants indicating the type of the data value: + data の値の種類を表す以下の定数のいずれか： @@ -4589,7 +4589,7 @@ - Informational text. + なんらかの情報を表すテキスト。 @@ -4600,7 +4600,7 @@ - Header (or header-like) data received from the peer. + 相手から受信したヘッダー (あるいはヘッダーのような) データ。 @@ -4611,7 +4611,7 @@ - Header (or header-like) data sent to the peer. + 相手に送信したヘッダー (あるいはヘッダーのような) データ。 @@ -4622,8 +4622,8 @@ - Unprocessed protocol data received from the peer. - Even if the data is encoded or compressed, it is not provided decoded nor decompressed to this callback. + 相手から受信した未処理のプロトコルデータ。 + データがエンコードされていたり圧縮されていたりしたとしても、デコードされたデータや展開されたデータがコールバックへ渡されることはありません。 @@ -4634,7 +4634,7 @@ - Protocol data sent to the peer. + 相手に送信したプロトコルデータ。 @@ -4645,7 +4645,7 @@ - SSL/TLS (binary) data received from the peer. + 相手から受信した SSL/TLS の (バイナリ) データ。 @@ -4656,7 +4656,7 @@ - SSL/TLS (binary) data sent to the peer. + 相手に送信した SSL/TLS の (バイナリ) データ。 @@ -4667,7 +4667,7 @@ data - Verbose debug data of the type indicate by the type parameter. + type パラメータで示された種類の詳細なデバッグデータ。