<?php use JetBrains\PhpStorm\ArrayShape; use JetBrains\PhpStorm\Internal\LanguageLevelTypeAware; use JetBrains\PhpStorm\Internal\PhpStormStubsElementAvailable; use JetBrains\PhpStorm\Internal\TentativeType; use JetBrains\PhpStorm\Pure; class CURLFile { #[LanguageLevelTypeAware(['8.1' => 'string'], default: '')] public $name; #[LanguageLevelTypeAware(['8.1' => 'string'], default: '')] public $mime; #[LanguageLevelTypeAware(['8.1' => 'string'], default: '')] public $postname; /** * Create a CURLFile object * @link https://secure.php.net/manual/en/curlfile.construct.php * @param string $filename Path to the file which will be uploaded. * @param string $mime_type [optional] Mimetype of the file. * @param string $posted_filename [optional] Name of the file. * @since 5.5 */ public function __construct( #[LanguageLevelTypeAware(['8.0' => 'string'], default: '')] $filename, #[LanguageLevelTypeAware(['8.0' => 'string|null'], default: '')] $mime_type = '', #[LanguageLevelTypeAware(['8.0' => 'string|null'], default: '')] $posted_filename = '' ) {} /** * Get file name * @link https://secure.php.net/manual/en/curlfile.getfilename.php * @return string Returns file name. * @since 5.5 */ #[Pure] #[TentativeType] public function getFilename(): string {} /** * Get MIME type * @link https://secure.php.net/manual/en/curlfile.getmimetype.php * @return string Returns MIME type. * @since 5.5 */ #[Pure] #[TentativeType] public function getMimeType(): string {} /** * Get file name for POST * @link https://secure.php.net/manual/en/curlfile.getpostfilename.php * @return string Returns file name for POST. * @since 5.5 */ #[Pure] #[TentativeType] public function getPostFilename(): string {} /** * Set MIME type * @link https://secure.php.net/manual/en/curlfile.setmimetype.php * @param string $mime_type * @since 5.5 */ #[TentativeType] public function setMimeType(#[LanguageLevelTypeAware(['8.0' => 'string'], default: '')] $mime_type): void {} /** * Set file name for POST * https://secure.php.net/manual/en/curlfile.setpostfilename.php * @param string $posted_filename * @since 5.5 */ #[TentativeType] public function setPostFilename(#[LanguageLevelTypeAware(['8.0' => 'string'], default: '')] $posted_filename): void {} /** * @link https://secure.php.net/manual/en/curlfile.wakeup.php * Unserialization handler * @since 5.5 */ public function __wakeup() {} } /** * Initialize a cURL session * @link https://php.net/manual/en/function.curl-init.php * @param string|null $url [optional] * If provided, the CURLOPT_URL option will be set * to its value. You can manually set this using the * curl_setopt function. * * @return resource|false|CurlHandle a cURL handle on success, false on errors. */ #[LanguageLevelTypeAware(['8.0' => 'CurlHandle|false'], default: 'resource|false')] function curl_init(?string $url) {} /** * Copy a cURL handle along with all of its preferences * @link https://php.net/manual/en/function.curl-copy-handle.php * @param CurlHandle|resource $handle * @return CurlHandle|resource|false a new cURL handle. */ #[Pure] #[LanguageLevelTypeAware(['8.0' => 'CurlHandle|false'], default: 'resource|false')] function curl_copy_handle(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle) {} /** * Gets cURL version information * @link https://php.net/manual/en/function.curl-version.php * @param int $age [optional] Removed since version PHP 8.0. * @return array|false an associative array with the following elements: * <tr valign="top"> * <td>Indice</td> * <td>Value description</td> * </tr> * <tr valign="top"> * <td>version_number</td> * <td>cURL 24 bit version number</td> * </tr> * <tr valign="top"> * <td>version</td> * <td>cURL version number, as a string</td> * </tr> * <tr valign="top"> * <td>ssl_version_number</td> * <td>OpenSSL 24 bit version number</td> * </tr> * <tr valign="top"> * <td>ssl_version</td> * <td>OpenSSL version number, as a string</td> * </tr> * <tr valign="top"> * <td>libz_version</td> * <td>zlib version number, as a string</td> * </tr> * <tr valign="top"> * <td>host</td> * <td>Information about the host where cURL was built</td> * </tr> * <tr valign="top"> * <td>age</td> * <td></td> * </tr> * <tr valign="top"> * <td>features</td> * <td>A bitmask of the CURL_VERSION_XXX constants</td> * </tr> * <tr valign="top"> * <td>protocols</td> * <td>An array of protocols names supported by cURL</td> * </tr> */ #[ArrayShape(["version_number" => "string", "version" => "string", "ssl_version_number" => "int", "ssl_version" => "string", "libz_version" => "string", "host" => "string", "age" => "int", "features" => "int", "protocols" => "array"])] #[Pure] function curl_version(#[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] $age = null): array|false {} /** * Set an option for a cURL transfer * @link https://php.net/manual/en/function.curl-setopt.php * @param CurlHandle|resource $handle * @param int $option * The CURLOPT_XXX option to set. * * @param mixed|callable $value * The value to be set on option. * * * value should be a bool for the * following values of the option parameter: * <table class="doctable informaltable"> * * <thead> * <tr> * <th>Option</th> * <th>Set value to</th> * <th>Notes</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURLOPT_AUTOREFERER</td> * <td style="vertical-align: top;"> * TRUE to automatically set the Referer: field in * requests where it follows a Location: redirect. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_BINARYTRANSFER</td> * <td style="vertical-align: top;"> * TRUE to return the raw output when * CURLOPT_RETURNTRANSFER is used. * </td> * <td style="vertical-align: top;"> * From PHP 5.1.3, this option has no effect: the raw output will * always be returned when * CURLOPT_RETURNTRANSFER is used. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_COOKIESESSION</td> * <td style="vertical-align: top;"> * TRUE to mark this as a new cookie "session". It will force libcurl * to ignore all cookies it is about to load that are "session cookies" * from the previous session. By default, libcurl 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CERTINFO</td> * <td style="vertical-align: top;"> * TRUE to output SSL certification information to STDERR * on secure transfers. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.19.1. * Available since PHP 5.3.2. * Requires CURLOPT_VERBOSE to be on to have an effect. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CONNECT_ONLY</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * Added in 7.15.2. * Available since PHP 5.5.0. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CRLF</td> * <td style="vertical-align: top;"> * TRUE to convert Unix newlines to CRLF newlines * on transfers. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_DNS_USE_GLOBAL_CACHE</td> * <td style="vertical-align: top;"> * TRUE to use a global DNS cache. This option is * not thread-safe and is enabled by default. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FAILONERROR</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FILETIME</td> * <td style="vertical-align: top;"> * TRUE to attempt to retrieve the modification * date of the remote document. This value can be retrieved using * the CURLINFO_FILETIME option with * {@see curl_getinfo()}. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FOLLOWLOCATION</td> * <td style="vertical-align: top;"> * TRUE to follow any * "Location: " header that the server sends as * part of the HTTP header (note this is recursive, PHP will follow as * many "Location: " headers that it is sent, * unless CURLOPT_MAXREDIRS is set). * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FORBID_REUSE</td> * <td style="vertical-align: top;"> * TRUE to force the connection to explicitly * close when it has finished processing, and not be pooled for reuse. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FRESH_CONNECT</td> * <td style="vertical-align: top;"> * TRUE to force the use of a new connection * instead of a cached one. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTP_USE_EPRT</td> * <td style="vertical-align: top;"> * TRUE to use EPRT (and LPRT) when doing active * FTP downloads. Use FALSE to disable EPRT and LPRT and use PORT * only. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTP_USE_EPSV</td> * <td style="vertical-align: top;"> * TRUE to first try an EPSV command for FTP * transfers before reverting back to PASV. Set to FALSE * to disable EPSV. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTP_CREATE_MISSING_DIRS</td> * <td style="vertical-align: top;"> * TRUE to create missing directories when an FTP operation * encounters a path that currently doesn't exist. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTPAPPEND</td> * <td style="vertical-align: top;"> * TRUE to append to the remote file instead of * overwriting it. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_TCP_NODELAY</td> * <td style="vertical-align: top;"> * TRUE to disable TCP's Nagle algorithm, which tries to minimize * the number of small packets on the network. * </td> * <td style="vertical-align: top;"> * Available since PHP 5.2.1 for versions compiled with libcurl 7.11.2 or * greater. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTPASCII</td> * <td style="vertical-align: top;"> * An alias of * CURLOPT_TRANSFERTEXT. Use that instead. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTPLISTONLY</td> * <td style="vertical-align: top;"> * TRUE to only list the names of an FTP * directory. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_HEADER</td> * <td style="vertical-align: top;"> * TRUE to include the header in the output. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td>CURLINFO_HEADER_OUT</td> * <td style="vertical-align: top;"> * TRUE to track the handle's request string. * </td> * <td style="vertical-align: top;"> * Available since PHP 5.1.3. The CURLINFO_ * prefix is intentional. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_HTTPGET</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_HTTPPROXYTUNNEL</td> * <td style="vertical-align: top;"> * TRUE to tunnel through a given HTTP proxy. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_MUTE</td> * <td style="vertical-align: top;"> * TRUE to be completely silent with regards to * the cURL functions. * </td> * <td style="vertical-align: top;"> * Removed in cURL 7.15.5 (You can use CURLOPT_RETURNTRANSFER instead) * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_NETRC</td> * <td style="vertical-align: top;"> * TRUE to scan the <var class="filename">~/.netrc</var> * file to find a username and password for the remote site that * a connection is being established with. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_NOBODY</td> * <td style="vertical-align: top;"> * TRUE to exclude the body from the output. * Request method is then set to HEAD. Changing this to FALSE does * not change it to GET. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_NOPROGRESS</td> * <td style="vertical-align: top;"> * TRUE to disable the progress meter for cURL transfers. * <blockquote class="note">Note: * * PHP automatically sets this option to TRUE, this should only be * changed for debugging purposes. * * </blockquote> * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_NOSIGNAL</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.10. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_POST</td> * <td style="vertical-align: top;"> * TRUE to do a regular HTTP POST. This POST is the * normal application/x-www-form-urlencoded kind, * most commonly used by HTML forms. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PUT</td> * <td style="vertical-align: top;"> * TRUE to HTTP PUT a file. The file to PUT must * be set with CURLOPT_INFILE and * CURLOPT_INFILESIZE. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_RETURNTRANSFER</td> * <td style="vertical-align: top;"> * TRUE to return the transfer as a string of the * return value of {@see curl_exec()} instead of outputting * it out directly. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SAFE_UPLOAD</td> * <td style="vertical-align: top;"> * TRUE to disable support for the @ prefix for * uploading files in CURLOPT_POSTFIELDS, which * means that values starting with @ can be safely * passed as fields. {@see CURLFile} may be used for * uploads instead. * </td> * <td style="vertical-align: top;"> * Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 * changes the default value to TRUE. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSL_VERIFYPEER</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * TRUE by default as of cURL 7.10. Default bundle installed as of * cURL 7.10. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_TRANSFERTEXT</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_UNRESTRICTED_AUTH</td> * <td style="vertical-align: top;"> * TRUE to keep sending the username and password * when following locations (using * CURLOPT_FOLLOWLOCATION), even when the * hostname has changed. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_UPLOAD</td> * <td style="vertical-align: top;"> * TRUE to prepare for an upload. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_VERBOSE</td> * <td style="vertical-align: top;"> * TRUE to output verbose information. Writes * output to STDERR, or the file specified using * CURLOPT_STDERR. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * </tbody> * * </table> * * value should be an integer for the following values of the option parameter: * <table> * * <thead> * <tr> * <th>Option</th> * <th>Set value to</th> * <th>Notes</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURLOPT_BUFFERSIZE</td> * <td style="vertical-align: top;"> * The size of the buffer to use for each read. There is no guarantee * this request will be fulfilled, however. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.10. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CLOSEPOLICY</td> * <td style="vertical-align: top;"> * One of the CURLCLOSEPOLICY_* values. * <blockquote class="note">Note: * * This option is deprecated, as it was never implemented in cURL and * never had any effect. * * </blockquote> * </td> * <td style="vertical-align: top;"> * Removed in PHP 5.6.0. * </td> * </tr> * * <tr> * <td>CURLOPT_CONNECTTIMEOUT</td> * <td style="vertical-align: top;"> * The number of seconds to wait while trying to connect. Use 0 to * wait indefinitely. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CONNECTTIMEOUT_MS</td> * <td style="vertical-align: top;"> * The number of milliseconds to wait while trying to connect. Use 0 to * wait indefinitely. * * If libcurl 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.2. Available since PHP 5.2.3. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_DNS_CACHE_TIMEOUT</td> * <td style="vertical-align: top;"> * The number of seconds to keep DNS entries in memory. This * option is set to 120 (2 minutes) by default. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTPSSLAUTH</td> * <td style="vertical-align: top;"> * The FTP authentication method (when is activated): * CURLFTPAUTH_SSL (try SSL first), * CURLFTPAUTH_TLS (try TLS first), or * CURLFTPAUTH_DEFAULT (let cURL decide). * </td> * <td style="vertical-align: top;"> * Added in cURL 7.12.2. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_HTTP_VERSION</td> * <td style="vertical-align: top;"> * <code class="parameter">CURL_HTTP_VERSION_NONE</code> (default, lets CURL * decide which version to use), * <code class="parameter">CURL_HTTP_VERSION_1_0</code> (forces HTTP/1.0), * or <code class="parameter">CURL_HTTP_VERSION_1_1</code> (forces HTTP/1.1). * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_HTTPAUTH</td> * <td style="vertical-align: top;"> * * The HTTP authentication method(s) to use. The options are: * <code class="parameter">CURLAUTH_BASIC</code>, * <code class="parameter">CURLAUTH_DIGEST</code>, * <code class="parameter">CURLAUTH_GSSNEGOTIATE</code>, * <code class="parameter">CURLAUTH_NTLM</code>, * <code class="parameter">CURLAUTH_ANY</code>, and * <code class="parameter">CURLAUTH_ANYSAFE</code>. * * * The bitwise | (or) operator can be used to combine * more than one method. If this is done, cURL will poll the server to see * what methods it supports and pick the best one. * * * <code class="parameter">CURLAUTH_ANY</code> is an alias for * CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM. * * * <code class="parameter">CURLAUTH_ANYSAFE</code> is an alias for * CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM. * * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_INFILESIZE</td> * <td style="vertical-align: top;"> * The expected size, in bytes, of the file when uploading a file to * a remote site. Note that using this option will not stop libcurl * from sending more data, as exactly what is sent depends on * CURLOPT_READFUNCTION. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_LOW_SPEED_LIMIT</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_LOW_SPEED_TIME</td> * <td style="vertical-align: top;"> * The number of seconds the transfer speed should be below * CURLOPT_LOW_SPEED_LIMIT before PHP considers * the transfer too slow and aborts. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_MAXCONNECTS</td> * <td style="vertical-align: top;"> * The maximum amount of persistent connections that are allowed. * When the limit is reached, * CURLOPT_CLOSEPOLICY is used to determine * which connection to close. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_MAXREDIRS</td> * <td style="vertical-align: top;"> * The maximum amount of HTTP redirections to follow. Use this option * alongside CURLOPT_FOLLOWLOCATION. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PORT</td> * <td style="vertical-align: top;"> * An alternative port number to connect to. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_POSTREDIR</td> * <td style="vertical-align: top;"> * A bitmask of 1 (301 Moved Permanently), 2 (302 Found) * vand 4 (303 See Other) if the HTTP POST method should be maintained * when CURLOPT_FOLLOWLOCATION is set and a * specific type of redirect occurs. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.19.1. Available since PHP 5.3.2. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROTOCOLS</td> * <td style="vertical-align: top;"> * * Bitmask of CURLPROTO_* values. If used, this bitmask * limits what protocols libcurl may use in the transfer. This allows you to have * a libcurl built to support a wide range of protocols but still limit specific * transfers to only be allowed to use a subset of them. By default libcurl will * accept all protocols it supports. * See also CURLOPT_REDIR_PROTOCOLS. * * * Valid protocol options are: * <code class="parameter">CURLPROTO_HTTP</code>, * <code class="parameter">CURLPROTO_HTTPS</code>, * <code class="parameter">CURLPROTO_FTP</code>, * <code class="parameter">CURLPROTO_FTPS</code>, * <code class="parameter">CURLPROTO_SCP</code>, * <code class="parameter">CURLPROTO_SFTP</code>, * <code class="parameter">CURLPROTO_TELNET</code>, * <code class="parameter">CURLPROTO_LDAP</code>, * <code class="parameter">CURLPROTO_LDAPS</code>, * <code class="parameter">CURLPROTO_DICT</code>, * <code class="parameter">CURLPROTO_FILE</code>, * <code class="parameter">CURLPROTO_TFTP</code>, * <code class="parameter">CURLPROTO_ALL</code> * * </td> * <td style="vertical-align: top;"> * Added in cURL 7.19.4. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROXYAUTH</td> * <td style="vertical-align: top;"> * The HTTP authentication method(s) to use for the proxy connection. * Use the same bitmasks as described in * CURLOPT_HTTPAUTH. For proxy authentication, * only <code class="parameter">CURLAUTH_BASIC</code> and * <code class="parameter">CURLAUTH_NTLM</code> are currently supported. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.10.7. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROXYPORT</td> * <td style="vertical-align: top;"> * The port number of the proxy to connect to. This port number can * also be set in CURLOPT_PROXY. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROXYTYPE</td> * <td style="vertical-align: top;"> * Either CURLPROXY_HTTP (default), * CURLPROXY_SOCKS4, * CURLPROXY_SOCKS5, * CURLPROXY_SOCKS4A or * CURLPROXY_SOCKS5_HOSTNAME. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.10. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_REDIR_PROTOCOLS</td> * <td style="vertical-align: top;"> * Bitmask of CURLPROTO_* values. If used, this bitmask * limits what protocols libcurl may use in a transfer that it follows to in * a redirect when CURLOPT_FOLLOWLOCATION is enabled. * This allows you to limit specific transfers to only be allowed to use a subset * of protocols in redirections. By default libcurl will allow all protocols * except for FILE and SCP. This is a difference compared to pre-7.19.4 versions * which unconditionally would follow to all protocols supported. * See also CURLOPT_PROTOCOLS for protocol constant values. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.19.4. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_RESUME_FROM</td> * <td style="vertical-align: top;"> * The offset, in bytes, to resume a transfer from. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSL_VERIFYHOST</td> * <td style="vertical-align: top;"> * 1 to check the existence of a common name in the * SSL peer certificate. 2 to check the existence of * a common name and also verify that it matches the hostname * provided. In production environments the value of this option * should be kept at 2 (default value). * </td> * <td style="vertical-align: top;"> * Support for value 1 removed in cURL 7.28.1 * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLVERSION</td> * <td style="vertical-align: top;"> * One of CURL_SSLVERSION_DEFAULT (0), * CURL_SSLVERSION_TLSv1 (1), * CURL_SSLVERSION_SSLv2 (2), * CURL_SSLVERSION_SSLv3 (3), * CURL_SSLVERSION_TLSv1_0 (4), * CURL_SSLVERSION_TLSv1_1 (5) or * CURL_SSLVERSION_TLSv1_2 (6). * <blockquote class="note">Note: * * Your best bet is to not set this and let it use the default. * Setting it to 2 or 3 is very dangerous given the known * vulnerabilities in SSLv2 and SSLv3. * * </blockquote> * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_TIMECONDITION</td> * <td style="vertical-align: top;"> * 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</code> is <code>TRUE. * Use <code class="parameter">CURL_TIMECOND_IFUNMODSINCE</code> for the reverse * effect. <code class="parameter">CURL_TIMECOND_IFMODSINCE</code> is the * default. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_TIMEOUT</td> * <td style="vertical-align: top;"> * The maximum number of seconds to allow cURL functions to execute. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_TIMEOUT_MS</td> * <td style="vertical-align: top;"> * The maximum number of milliseconds to allow cURL functions to * execute. * * If libcurl 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.2. Available since PHP 5.2.3. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_TIMEVALUE</td> * <td style="vertical-align: top;"> * The time in seconds since January 1st, 1970. The time will be used * by CURLOPT_TIMECONDITION. By default, * <code class="parameter">CURL_TIMECOND_IFMODSINCE</code> is used. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_MAX_RECV_SPEED_LARGE</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.15.5. Available since PHP 5.4.0. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_MAX_SEND_SPEED_LARGE</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.15.5. Available since PHP 5.4.0. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSH_AUTH_TYPES</td> * <td style="vertical-align: top;"> * A bitmask consisting of one or more of * CURLSSH_AUTH_PUBLICKEY, * CURLSSH_AUTH_PASSWORD, * CURLSSH_AUTH_HOST, * CURLSSH_AUTH_KEYBOARD. Set to * CURLSSH_AUTH_ANY to let libcurl pick one. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_IPRESOLVE</td> * <td style="vertical-align: top;"> * 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, possible values are * CURL_IPRESOLVE_WHATEVER, * CURL_IPRESOLVE_V4, * CURL_IPRESOLVE_V6, by default * CURL_IPRESOLVE_WHATEVER. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.10.8. * </td> * </tr> * * </tbody> * * </table> * * value should be a string for the following values of the option parameter: * <table class="doctable informaltable"> * * <thead> * <tr> * <th>Option</th> * <th>Set <code class="parameter">value</code> to</th> * <th>Notes</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURLOPT_CAINFO</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * Might require an absolute path. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CAPATH</td> * <td style="vertical-align: top;"> * A directory that holds multiple CA certificates. Use this option * alongside CURLOPT_SSL_VERIFYPEER. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_COOKIE</td> * <td style="vertical-align: top;"> * 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") * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_COOKIEFILE</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_COOKIEJAR</td> * <td style="vertical-align: top;"> * The name of a file to save all internal cookies to when the handle is closed, * e.g. after a call to curl_close. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CUSTOMREQUEST</td> * <td style="vertical-align: top;"> * 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. * <blockquote class="note">Note: * * Don't do this without making sure the server supports the custom * request method first. * * </blockquote> * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_EGDSOCKET</td> * <td style="vertical-align: top;"> * Like CURLOPT_RANDOM_FILE, except a filename * to an Entropy Gathering Daemon socket. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_ENCODING</td> * <td style="vertical-align: top;"> * The contents of the "Accept-Encoding: " header. * This enables decoding of the response. Supported encodings are * "identity", "deflate", and * "gzip". If an empty string, "", * is set, a header containing all supported encoding types is sent. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.10. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTPPORT</td> * <td style="vertical-align: top;"> * The value 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 * systems default IP address. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_INTERFACE</td> * <td style="vertical-align: top;"> * The name of the outgoing network interface to use. This can be an * interface name, an IP address or a host name. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_KEYPASSWD</td> * <td style="vertical-align: top;"> * The password required to use the CURLOPT_SSLKEY * or CURLOPT_SSH_PRIVATE_KEYFILE private key. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_KRB4LEVEL</td> * <td style="vertical-align: top;"> * The KRB4 (Kerberos 4) security level. Any of the following 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_POSTFIELDS</td> * <td style="vertical-align: top;"> * * The full data to post in a HTTP "POST" operation. * To post a file, prepend a filename with @ and * use the full path. The filetype can be explicitly specified by * following the filename with the type in the format * ';type=mimetype'. 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 <code class="parameter">value</code> is an array, the * Content-Type header will be set to * multipart/form-data. * * * As of PHP 5.2.0, <code class="parameter">value</code> must be an array if * files are passed to this option with the @ prefix. * * * As of PHP 5.5.0, the @ prefix is deprecated and * files can be sent using <a href="class.curlfile.php" class="classname">CURLFile</a>. The * @ prefix can be disabled for safe passing of * values beginning with @ by setting the * CURLOPT_SAFE_UPLOAD</code> option to <code>TRUE. * * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROXY</td> * <td style="vertical-align: top;"> * The HTTP proxy to tunnel requests through. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROXYUSERPWD</td> * <td style="vertical-align: top;"> * A username and password formatted as * "[username]:[password]" to use for the * connection to the proxy. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_RANDOM_FILE</td> * <td style="vertical-align: top;"> * A filename to be used to seed the random number generator for SSL. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_RANGE</td> * <td style="vertical-align: top;"> * 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". * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_REFERER</td> * <td style="vertical-align: top;"> * The contents of the "Referer: " header to be used * in a HTTP request. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSH_HOST_PUBLIC_KEY_MD5</td> * <td style="vertical-align: top;"> * A string containing 32 hexadecimal digits. The string should be the * MD5 checksum of the remote host's public key, and libcurl will reject * the connection to the host unless the md5sums match. * This option is only for SCP and SFTP transfers. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.17.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSH_PUBLIC_KEYFILE</td> * <td style="vertical-align: top;"> * The file name for your public key. If not used, libcurl 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSH_PRIVATE_KEYFILE</td> * <td style="vertical-align: top;"> * The file name for your private key. If not used, libcurl 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSL_CIPHER_LIST</td> * <td style="vertical-align: top;"> * A list of ciphers to use for SSL. For example, * RC4-SHA and TLSv1 are valid * cipher lists. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLCERT</td> * <td style="vertical-align: top;"> * The name of a file containing a PEM formatted certificate. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLCERTPASSWD</td> * <td style="vertical-align: top;"> * The password required to use the * CURLOPT_SSLCERT certificate. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLCERTTYPE</td> * <td style="vertical-align: top;"> * The format of the certificate. Supported formats are * "PEM" (default), "DER", * and "ENG". * </td> * <td style="vertical-align: top;"> * Added in cURL 7.9.3. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLENGINE</td> * <td style="vertical-align: top;"> * The identifier for the crypto engine of the private SSL key * specified in CURLOPT_SSLKEY. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLENGINE_DEFAULT</td> * <td style="vertical-align: top;"> * The identifier for the crypto engine used for asymmetric crypto * operations. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLKEY</td> * <td style="vertical-align: top;"> * The name of a file containing a private SSL key. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLKEYPASSWD</td> * <td style="vertical-align: top;"> * The secret password needed to use the private SSL key specified in * CURLOPT_SSLKEY. * <blockquote class="note">Note: * * Since this option contains a sensitive password, remember to keep * the PHP script it is contained within safe. * * </blockquote> * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLKEYTYPE</td> * <td style="vertical-align: top;"> * The key type of the private SSL key specified in * CURLOPT_SSLKEY. Supported key types are * "PEM" (default), "DER", * and "ENG". * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_URL</td> * <td style="vertical-align: top;"> * The URL to fetch. This can also be set when initializing a * session with {@see curl_init()}. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_USERAGENT</td> * <td style="vertical-align: top;"> * The contents of the "User-Agent: " header to be * used in a HTTP request. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_USERPWD</td> * <td style="vertical-align: top;"> * A username and password formatted as * "[username]:[password]" to use for the * connection. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * </tbody> * * </table> * <table class="doctable informaltable"> * * <thead> * <tr> * <th>Option</th> * <th>Set <code class="parameter">value</code> to</th> * <th>Notes</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURLOPT_CAINFO</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * Might require an absolute path. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CAPATH</td> * <td style="vertical-align: top;"> * A directory that holds multiple CA certificates. Use this option * alongside CURLOPT_SSL_VERIFYPEER. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_COOKIE</td> * <td style="vertical-align: top;"> * 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") * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_COOKIEFILE</td> * <td style="vertical-align: top;"> * 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_COOKIEJAR</td> * <td style="vertical-align: top;"> * The name of a file to save all internal cookies to when the handle is closed, * e.g. after a call to curl_close. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_CUSTOMREQUEST</td> * <td style="vertical-align: top;"> * 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. * <blockquote class="note">Note: * * Don't do this without making sure the server supports the custom * request method first. * * </blockquote> * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_EGDSOCKET</td> * <td style="vertical-align: top;"> * Like CURLOPT_RANDOM_FILE, except a filename * to an Entropy Gathering Daemon socket. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_ENCODING</td> * <td style="vertical-align: top;"> * The contents of the "Accept-Encoding: " header. * This enables decoding of the response. Supported encodings are * "identity", "deflate", and * "gzip". If an empty string, "", * is set, a header containing all supported encoding types is sent. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.10. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_FTPPORT</td> * <td style="vertical-align: top;"> * The value 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 * systems default IP address. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_INTERFACE</td> * <td style="vertical-align: top;"> * The name of the outgoing network interface to use. This can be an * interface name, an IP address or a host name. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_KEYPASSWD</td> * <td style="vertical-align: top;"> * The password required to use the CURLOPT_SSLKEY * or CURLOPT_SSH_PRIVATE_KEYFILE private key. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_KRB4LEVEL</td> * <td style="vertical-align: top;"> * The KRB4 (Kerberos 4) security level. Any of the following 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. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_POSTFIELDS</td> * <td style="vertical-align: top;"> * * The full data to post in a HTTP "POST" operation. * To post a file, prepend a filename with @ and * use the full path. The filetype can be explicitly specified by * following the filename with the type in the format * ';type=mimetype'. 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 <code class="parameter">value</code> is an array, the * Content-Type header will be set to * multipart/form-data. * * * As of PHP 5.2.0, <code class="parameter">value</code> must be an array if * files are passed to this option with the @ prefix. * * * As of PHP 5.5.0, the @ prefix is deprecated and * files can be sent using <a href="class.curlfile.php" class="classname">CURLFile</a>. The * @ prefix can be disabled for safe passing of * values beginning with @ by setting the * CURLOPT_SAFE_UPLOAD</code> option to <code>TRUE. * * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROXY</td> * <td style="vertical-align: top;"> * The HTTP proxy to tunnel requests through. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROXYUSERPWD</td> * <td style="vertical-align: top;"> * A username and password formatted as * "[username]:[password]" to use for the * connection to the proxy. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_RANDOM_FILE</td> * <td style="vertical-align: top;"> * A filename to be used to seed the random number generator for SSL. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_RANGE</td> * <td style="vertical-align: top;"> * 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". * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_REFERER</td> * <td style="vertical-align: top;"> * The contents of the "Referer: " header to be used * in a HTTP request. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSH_HOST_PUBLIC_KEY_MD5</td> * <td style="vertical-align: top;"> * A string containing 32 hexadecimal digits. The string should be the * MD5 checksum of the remote host's public key, and libcurl will reject * the connection to the host unless the md5sums match. * This option is only for SCP and SFTP transfers. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.17.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSH_PUBLIC_KEYFILE</td> * <td style="vertical-align: top;"> * The file name for your public key. If not used, libcurl 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSH_PRIVATE_KEYFILE</td> * <td style="vertical-align: top;"> * The file name for your private key. If not used, libcurl 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. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.16.1. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSL_CIPHER_LIST</td> * <td style="vertical-align: top;"> * A list of ciphers to use for SSL. For example, * RC4-SHA and TLSv1 are valid * cipher lists. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLCERT</td> * <td style="vertical-align: top;"> * The name of a file containing a PEM formatted certificate. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLCERTPASSWD</td> * <td style="vertical-align: top;"> * The password required to use the * CURLOPT_SSLCERT certificate. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLCERTTYPE</td> * <td style="vertical-align: top;"> * The format of the certificate. Supported formats are * "PEM" (default), "DER", * and "ENG". * </td> * <td style="vertical-align: top;"> * Added in cURL 7.9.3. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLENGINE</td> * <td style="vertical-align: top;"> * The identifier for the crypto engine of the private SSL key * specified in CURLOPT_SSLKEY. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLENGINE_DEFAULT</td> * <td style="vertical-align: top;"> * The identifier for the crypto engine used for asymmetric crypto * operations. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLKEY</td> * <td style="vertical-align: top;"> * The name of a file containing a private SSL key. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLKEYPASSWD</td> * <td style="vertical-align: top;"> * The secret password needed to use the private SSL key specified in * CURLOPT_SSLKEY. * <blockquote class="note">Note: * * Since this option contains a sensitive password, remember to keep * the PHP script it is contained within safe. * * </blockquote> * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_SSLKEYTYPE</td> * <td style="vertical-align: top;"> * The key type of the private SSL key specified in * CURLOPT_SSLKEY. Supported key types are * "PEM" (default), "DER", * and "ENG". * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_URL</td> * <td style="vertical-align: top;"> * The URL to fetch. This can also be set when initializing a * session with <a href="function.curl-init.php" class="function">curl_init()</a>. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_USERAGENT</td> * <td style="vertical-align: top;"> * The contents of the "User-Agent: " header to be * used in a HTTP request. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_USERPWD</td> * <td style="vertical-align: top;"> * A username and password formatted as * "[username]:[password]" to use for the * connection. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * </tbody> * * </table> * * value should be an array for the following values of the option parameter: * <table class="doctable informaltable"> * * <thead> * <tr> * <th>Option</th> * <th>Set <code class="parameter">value</code> to</th> * <th>Notes</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURLOPT_HTTP200ALIASES</td> * <td style="vertical-align: top;"> * An array of HTTP 200 responses that will be treated as valid * responses and not as errors. * </td> * <td style="vertical-align: top;"> * Added in cURL 7.10.3. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_HTTPHEADER</td> * <td style="vertical-align: top;"> * An array of HTTP header fields to set, in the format * <code class="code"> * array('Content-type: text/plain', 'Content-length: 100') * </code> * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_POSTQUOTE</td> * <td style="vertical-align: top;"> * An array of FTP commands to execute on the server after the FTP * request has been performed. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_QUOTE</td> * <td style="vertical-align: top;"> * An array of FTP commands to execute on the server prior to the FTP * request. * </td> * <td style="vertical-align: top;"> * </td> * </tr> * * </tbody> * * </table> * value should be a stream resource (using {@see fopen()}, for example) for the following values of the option parameter: * <table class="doctable informaltable"> * * <thead> * <tr> * <th>Option</th> * <th>Set <code class="parameter">value</code> to</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURLOPT_FILE</td> * <td style="vertical-align: top;"> * The file that the transfer should be written to. The default * is STDOUT (the browser window). * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_INFILE</td> * <td style="vertical-align: top;"> * The file that the transfer should be read from when uploading. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_STDERR</td> * <td style="vertical-align: top;"> * An alternative location to output errors to instead of * STDERR. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_WRITEHEADER</td> * <td style="vertical-align: top;"> * The file that the header part of the transfer is written to. * </td> * </tr> * * </tbody> * * </table> * value should be the name of a valid function or a Closure for the following values of the option parameter: * <table class="doctable informaltable"> * * <thead> * <tr> * <th>Option</th> * <th>Set <code class="parameter">value</code> to</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURLOPT_HEADERFUNCTION</td> * <td style="vertical-align: top;"> * A callback accepting two parameters. * The first is the cURL resource, the second is a * string with the header data to be written. The header data must * be written by this callback. Return the number of * bytes written. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PASSWDFUNCTION</td> * <td style="vertical-align: top;"> * A callback accepting three parameters. * The first is the cURL resource, the second is a * string containing a password prompt, and the third is the maximum * password length. Return the string containing the password. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_PROGRESSFUNCTION</td> * <td style="vertical-align: top;"> * * A callback accepting five parameters. * The first is the cURL resource, the second is the total number of * bytes expected to be downloaded in this transfer, the third is * the number of bytes downloaded so far, the fourth is the total * number of bytes expected to be uploaded in this transfer, and the * fifth is the number of bytes uploaded so far. * * <blockquote class="note">Note: * * The callback is only called when the CURLOPT_NOPROGRESS * option is set to FALSE. * * </blockquote> * * Return a non-zero value to abort the transfer. In which case, the * transfer will set a CURLE_ABORTED_BY_CALLBACK * error. * * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_READFUNCTION</td> * <td style="vertical-align: top;"> * A callback accepting three parameters. * The first is the cURL resource, the second is a * stream resource provided to cURL through the option * CURLOPT_INFILE, and the third is the maximum * amount of data to be read. The callback must 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. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLOPT_WRITEFUNCTION</td> * <td style="vertical-align: top;"> * A callback accepting two parameters. * The first is the cURL resource, and the second is a * string with the data to be written. The data must be saved by * this callback. It must return the exact number of bytes written * or the transfer will be aborted with an error. * </td> * </tr> * * </tbody> * * </table> * Other values: * <table class="doctable informaltable"> * * <thead> * <tr> * <th>Option</th> * <th>Set <code class="parameter">value</code> to</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURLOPT_SHARE</td> * <td style="vertical-align: top;"> * A result of {@see curl_share_init()}. Makes the cURL * handle to use the data from the shared handle. * </td> * </tr> * </tbody> * * </table> * @return bool true on success or false on failure. */ function curl_setopt(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle, int $option, mixed $value): bool {} /** * Set multiple options for a cURL transfer * @link https://php.net/manual/en/function.curl-setopt-array.php * @param CurlHandle|resource $handle * @param array $options * An array specifying which options to set and their values. * The keys should be valid curl_setopt constants or * their integer equivalents. * * @return bool true if all options were successfully set. If an option could * not be successfully set, false is immediately returned, ignoring any * future options in the options array. * @since 5.1.3 */ function curl_setopt_array(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle, array $options): bool {} /** * (PHP 5 >=5.5.0) * Close a cURL share handle * @link https://secure.php.net/manual/en/function.curl-share-close.php * @param CurlShareHandle|resource $share_handle * A cURL share handle returned by {@link https://secure.php.net/manual/en/function.curl-share-init.php curl_share_init()} * * @return void * @since 5.5 */ function curl_share_close(#[LanguageLevelTypeAware(['8.0' => 'CurlShareHandle'], default: 'resource')] $share_handle): void {} /** * (PHP 5 >=5.5.0) * Initialize a cURL share handle * @link https://secure.php.net/manual/en/function.curl-share-init.php * @return resource|CurlShareHandle Returns resource of type "cURL Share Handle". * @since 5.5 */ #[LanguageLevelTypeAware(['8.0' => 'CurlShareHandle'], default: 'resource')] function curl_share_init() {} /** * (PHP 5 >=5.5.0) * Set an option for a cURL share handle. * @link https://secure.php.net/manual/en/function.curl-share-setopt.php * @param CurlShareHandle|resource $share_handle * A cURL share handle returned by {@link https://secure.php.net/manual/en/function.curl-share-init.php curl_share_init()}. * * @param int $option <table> * * <thead> * <tr> * <th>Option</th> * <th>Description</th> * </tr> * </thead> * * <tbody> * <tr> * <td style="vertical-align: top;">CURLSHOPT_SHARE</td> * <td style="vertical-align: top;"> * Specifies a type of data that should be shared. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLSHOPT_UNSHARE</td> * <td style="vertical-align: top;"> * Specifies a type of data that will be no longer shared. * </td> * </tr> * * </tbody> * * </table> * @param string $value <table> * * <thead> * <tr> * <th>Value</th> * <th>Description</th> * </tr> * </thead> * * <tbody class="tbody"> * <tr> * <td style="vertical-align: top;">CURL_LOCK_DATA_COOKIE</td> * <td style="vertical-align: top;"> * Shares cookie data. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURL_LOCK_DATA_DNS</td> * <td style="vertical-align: top;"> * Shares DNS cache. Note that when you use cURL multi handles, * all handles added to the same multi handle will share DNS cache * by default. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURL_LOCK_DATA_SSL_SESSION</td> * <td style="vertical-align: top;"> * Shares SSL session IDs, reducing the time spent on the SSL * handshake when reconnecting to the same server. Note that SSL * session IDs are reused within the same handle by default. * </td> * </tr> * * </tbody> * * </table> * * @return bool * Returns TRUE on success or FALSE on failure. * @since 5.5 */ function curl_share_setopt(#[LanguageLevelTypeAware(['8.0' => 'CurlShareHandle'], default: 'resource')] $share_handle, int $option, mixed $value): bool {} /** * (PHP 5 >=5.5.0) * Return string describing the given error code * @link https://secure.php.net/manual/en/function.curl-strerror.php * @param int $error_code * One of the {@link https://curl.haxx.se/libcurl/c/libcurl-errors.html  cURL error codes} constants. * * @return string|null Returns error description or NULL for invalid error code. * @since 5.5 */ #[Pure] function curl_strerror(int $error_code): ?string {} /** * (PHP 5 >=5.5.0) * Decodes the given URL encoded string * @link https://secure.php.net/manual/en/function.curl-unescape.php * @param CurlHandle|resource $handle A cURL handle returned by * {@link https://secure.php.net/manual/en/function.curl-init.php curl_init()}. * @param string $string * The URL encoded string to be decoded. * * @return string|false Returns decoded string or FALSE on failure. * @since 5.5 */ #[Pure] function curl_unescape(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle, string $string): string|false {} /** * Perform a cURL session * @link https://php.net/manual/en/function.curl-exec.php * @param CurlHandle|resource $handle * @return string|bool true on success or false on failure. However, if the CURLOPT_RETURNTRANSFER * option is set, it will return the result on success, false on failure. */ function curl_exec(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle): string|bool {} /** * Get information regarding a specific transfer * @link https://php.net/manual/en/function.curl-getinfo.php * @param CurlHandle|resource $handle * @param int|null $option [optional] * This may be one of the following constants: * <ul> * <li> * <code class="code">CURLINFO_EFFECTIVE_URL</code> - Last effective URL * </li> * <li> * <code class="code">CURLINFO_HTTP_CODE</code> - The last response code. As of cURL 7.10.8, this is a legacy alias of * <code class="code">CURLINFO_RESPONSE_CODE</code> * * </li> * <li> * <code class="code">CURLINFO_FILETIME</code> - Remote time of the retrieved document, with the * <code class="code">CURLOPT_FILETIME</code> * enabled; if -1 is returned the time of the document is unknown * </li> * <li> * <code class="code">CURLINFO_TOTAL_TIME</code> - Total transaction time in seconds for last transfer * </li> * <li> * <code class="code">CURLINFO_NAMELOOKUP_TIME</code> - Time in seconds until name resolving was complete * </li> * <li> * <code class="code">CURLINFO_CONNECT_TIME</code> - Time in seconds it took to establish the connection * </li> * <li> * <code class="code">CURLINFO_PRETRANSFER_TIME</code> - Time in seconds from start until just before file transfer begins * </li> * <li> * <code class="code">CURLINFO_STARTTRANSFER_TIME</code> - Time in seconds until the first byte is about to be transferred * </li> * <li> * <code class="code">CURLINFO_REDIRECT_COUNT</code> - Number of redirects, with the * <code class="code">CURLOPT_FOLLOWLOCATION</code> * option enabled * </li> * <li> * <code class="code">CURLINFO_REDIRECT_TIME</code> - Time in seconds of all redirection steps before final transaction was started, with the * <code class="code">CURLOPT_FOLLOWLOCATION</code> * option enabled * </li> * <li> * <code class="code">CURLINFO_REDIRECT_URL</code> - With the * <code class="code">CURLOPT_FOLLOWLOCATION</code> * option disabled: redirect URL found in the last transaction, that should be requested manually next. With the * <code class="code">CURLOPT_FOLLOWLOCATION</code> * option enabled: this is empty. The redirect URL in this case is available in * <code class="code">CURLINFO_EFFECTIVE_URL</code> * * </li> * <li> * <code class="code">CURLINFO_PRIMARY_IP</code> - IP address of the most recent connection * </li> * <li> * <code class="code">CURLINFO_PRIMARY_PORT</code> - Destination port of the most recent connection * </li> * <li> * <code class="code">CURLINFO_LOCAL_IP</code> - Local (source) IP address of the most recent connection * </li> * <li> * <code class="code">CURLINFO_LOCAL_PORT</code> - Local (source) port of the most recent connection * </li> * <li> * <code class="code">CURLINFO_SIZE_UPLOAD</code> - Total number of bytes uploaded * </li> * <li> * <code class="code">CURLINFO_SIZE_DOWNLOAD</code> - Total number of bytes downloaded * </li> * <li> * <code class="code">CURLINFO_SPEED_DOWNLOAD</code> - Average download speed * </li> * <li> * <code class="code">CURLINFO_SPEED_UPLOAD</code> - Average upload speed * </li> * <li> * <code class="code">CURLINFO_HEADER_SIZE</code> - Total size of all headers received * </li> * <li> * <code class="code">CURLINFO_HEADER_OUT</code> - The request string sent. For this to work, add the * <code class="code">CURLINFO_HEADER_OUT</code> * option to the handle by calling curl_setopt() * </li> * <li> * <code class="code">CURLINFO_REQUEST_SIZE</code> - Total size of issued requests, currently only for HTTP requests * </li> * <li> * <code class="code">CURLINFO_SSL_VERIFYRESULT</code> - Result of SSL certification verification requested by setting * <code class="code">CURLOPT_SSL_VERIFYPEER</code> * * </li> * <li> * <code class="code">CURLINFO_CONTENT_LENGTH_DOWNLOAD</code> - Content length of download, read from * <code class="code">Content-Length:</code> field * </li> * <li> * <code class="code">CURLINFO_CONTENT_LENGTH_UPLOAD</code> - Specified size of upload * </li> * <li> * <code class="code">CURLINFO_CONTENT_TYPE</code> * - * <code class="code">Content-Type:</code> of the requested document. NULL indicates server did not send valid * <code class="code">Content-Type:</code> header * </li> * <li> * <code class="code">CURLINFO_PRIVATE</code> - Private data associated with this cURL handle, previously set with the * <code class="code">CURLOPT_PRIVATE</code> * option of curl_setopt() * </li> * <li> * <code class="code">CURLINFO_RESPONSE_CODE</code> - The last response code * </li> * <li> * <code class="code">CURLINFO_HTTP_CONNECTCODE</code> - The CONNECT response code * </li> * <li> * <code class="code">CURLINFO_HTTPAUTH_AVAIL</code> - Bitmask indicating the authentication method(s) available according to the previous response * </li> * <li> * <code class="code">CURLINFO_PROXYAUTH_AVAIL</code> - Bitmask indicating the proxy authentication method(s) available according to the previous response * </li> * <li> * <code class="code">CURLINFO_OS_ERRNO</code> - Errno from a connect failure. The number is OS and system specific. * </li> * <li> * <code class="code">CURLINFO_NUM_CONNECTS</code> - Number of connections curl had to create to achieve the previous transfer * </li> * <li> * <code class="code">CURLINFO_SSL_ENGINES</code> - OpenSSL crypto-engines supported * </li> * <li> * <code class="code">CURLINFO_COOKIELIST</code> - All known cookies * </li> * <li> * <code class="code">CURLINFO_FTP_ENTRY_PATH</code> - Entry path in FTP server * </li> * <li> * <code class="code">CURLINFO_APPCONNECT_TIME</code> - Time in seconds it took from the start until the SSL/SSH connect/handshake to the remote host was completed * </li> * <li> * <code class="code">CURLINFO_CERTINFO</code> - TLS certificate chain * </li> * <li> * <code class="code">CURLINFO_CONDITION_UNMET</code> - Info on unmet time conditional * </li> * <li> * <code class="code">CURLINFO_RTSP_CLIENT_CSEQ</code> - Next RTSP client CSeq * </li> * <li> * <code class="code">CURLINFO_RTSP_CSEQ_RECV</code> - Recently received CSeq * </li> * <li> * <code class="code">CURLINFO_RTSP_SERVER_CSEQ</code> - Next RTSP server CSeq * </li> * <li> * <code class="code">CURLINFO_RTSP_SESSION_ID</code> - RTSP session ID * </li> * <li> * <code class="code">CURLINFO_CONTENT_LENGTH_DOWNLOAD_T</code> - The content-length of the download. This is the value read from the * <code class="code">Content-Type:</code> field. -1 if the size isn't known * </li> * <li> * <code class="code">CURLINFO_CONTENT_LENGTH_UPLOAD_T</code> - The specified size of the upload. -1 if the size isn't known * </li> * <li> * <code class="code">CURLINFO_HTTP_VERSION</code> - The version used in the last HTTP connection. The return value will be one of the defined * <code class="code">CURL_HTTP_VERSION_*</code> * constants or 0 if the version can't be determined * </li> * <li> * <code class="code">CURLINFO_PROTOCOL</code> - The protocol used in the last HTTP connection. The returned value will be exactly one of the * <code class="code">CURLPROTO_*</code> * values * </li> * <li> * <code class="code">CURLINFO_PROXY_SSL_VERIFYRESULT</code> - The result of the certificate verification that was requested (using the * <code class="code">CURLOPT_PROXY_SSL_VERIFYPEER</code> * option). Only used for HTTPS proxies * </li> * <li> * <code class="code">CURLINFO_SCHEME</code> - The URL scheme used for the most recent connection * </li> * <li> * <code class="code">CURLINFO_SIZE_DOWNLOAD_T</code> - Total number of bytes that were downloaded. The number is only for the latest transfer and will be reset again for each new transfer * </li> * <li> * <code class="code">CURLINFO_SIZE_UPLOAD_T</code> - Total number of bytes that were uploaded * </li> * <li> * <code class="code">CURLINFO_SPEED_DOWNLOAD_T</code> - The average download speed in bytes/second that curl measured for the complete download * </li> * <li> * <code class="code">CURLINFO_SPEED_UPLOAD_T</code> - The average upload speed in bytes/second that curl measured for the complete upload * </li> * <li> * <code class="code">CURLINFO_APPCONNECT_TIME_T</code> - Time, in microseconds, it took from the start until the SSL/SSH connect/handshake to the remote host was completed * </li> * <li> * <code class="code">CURLINFO_CONNECT_TIME_T</code> - Total time taken, in microseconds, from the start until the connection to the remote host (or proxy) was completed * </li> * <li> * <code class="code">CURLINFO_FILETIME_T</code> - Remote time of the retrieved document (as Unix timestamp), an alternative to * <code class="code">CURLINFO_FILETIME</code> * to allow systems with 32 bit long variables to extract dates outside of the 32bit timestamp range * </li> * <li> * <code class="code">CURLINFO_NAMELOOKUP_TIME_T</code> - Time in microseconds from the start until the name resolving was completed * </li> * <li> * <code class="code">CURLINFO_PRETRANSFER_TIME_T</code> - Time taken from the start until the file transfer is just about to begin, in microseconds * </li> * <li> * <code class="code">CURLINFO_REDIRECT_TIME_T</code> - Total time, in microseconds, it took for all redirection steps include name lookup, connect, pretransfer and transfer before final transaction was started * </li> * <li> * <code class="code">CURLINFO_STARTTRANSFER_TIME_T</code> - Time, in microseconds, it took from the start until the first byte is received * </li> * <li> * <code class="code">CURLINFO_TOTAL_TIME_T</code> - Total time in microseconds for the previous transfer, including name resolving, TCP connect etc. * </ul> * * @return mixed If <code class="parameter">$option</code> is given, returns its value as a string. * Otherwise, returns an associative array with the following elements * (which correspond to <code class="parameter">$option</code>), or false on failure: * <ul> * <li>url</li> * <li>content_type</li> * <li>http_code</li> * <li>header_size</li> * <li>request_size</li> * <li>filetime</li> * <li>ssl_verify_result</li> * <li>redirect_count</li> * <li>total_time</li> * <li>namelookup_time</li> * <li>connect_time</li> * <li>pretransfer_time</li> * <li>size_upload</li> * <li>size_download</li> * <li>speed_download</li> * <li>speed_upload</li> * <li>download_content_length</li> * <li>upload_content_length</li> * <li>starttransfer_time</li> * <li>redirect_time</li> * <li>certinfo</li> * <li>primary_ip</li> * <li>primary_port</li> * <li>local_ip</li> * <li>local_port</li> * <li>redirect_url</li> * <li>request_header (This is only set if the * <code>CURLINFO_HEADER_OUT</code> * is set by a previous call to curl_setopt() * </li> * </ul> */ #[Pure(true)] function curl_getinfo(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle, ?int $option): mixed {} /** * Return a string containing the last error for the current session * @link https://php.net/manual/en/function.curl-error.php * @param CurlHandle|resource $handle * @return string the error message or '' (the empty string) if no * error occurred. */ #[Pure(true)] function curl_error(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle): string {} /** * Return the last error number * @link https://php.net/manual/en/function.curl-errno.php * @param CurlHandle|resource $handle * @return int the error number or 0 (zero) if no error * occurred. */ #[Pure(true)] function curl_errno(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle): int {} /** * URL encodes the given string * @link https://secure.php.net/manual/en/function.curl-escape.php * @param CurlHandle|resource $handle * A cURL handle returned by * {@link https://secure.php.net/manual/en/function.curl-init.php curl_init()}. * @param string $string * The string to be encoded. * @return string|false Returns escaped string or FALSE on failure. * @since 5.5 */ #[Pure] function curl_escape(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle, string $string): string|false {} /** * (PHP 5 >= 5.5.0) * Create a CURLFile object * @link https://secure.php.net/manual/en/curlfile.construct.php * @param string $filename Path to the file which will be uploaded. * @param string|null $mime_type Mimetype of the file. * @param string|null $posted_filename Name of the file. * @return CURLFile * Returns a {@link https://secure.php.net/manual/en/class.curlfile.php CURLFile} object. * @since 5.5 */ #[Pure] function curl_file_create(string $filename, ?string $mime_type = null, ?string $posted_filename = null): CURLFile {} /** * Close a cURL session * @link https://php.net/manual/en/function.curl-close.php * @param CurlHandle|resource $handle * @return void */ function curl_close(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle): void {} /** * Returns a new cURL multi handle * @link https://php.net/manual/en/function.curl-multi-init.php * @return resource|CurlMultiHandle|false a cURL multi handle resource on success, false on failure. */ #[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] function curl_multi_init(): CurlMultiHandle {} /** * Add a normal cURL handle to a cURL multi handle * @link https://php.net/manual/en/function.curl-multi-add-handle.php * @param CurlMultiHandle|resource $multi_handle * @param CurlHandle|resource $handle * @return int 0 on success, or one of the CURLM_XXX errors * code. */ function curl_multi_add_handle(#[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] $multi_handle, #[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle): int {} /** * Remove a multi handle from a set of cURL handles * @link https://php.net/manual/en/function.curl-multi-remove-handle.php * @param CurlMultiHandle|resource $multi_handle * @param CurlHandle|resource $handle * @return int|false On success, returns one of the CURLM_XXX error codes, false on failure. */ #[LanguageLevelTypeAware(['8.0' => 'int'], default: 'int|false')] function curl_multi_remove_handle(#[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] $multi_handle, #[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle) {} /** * Wait for activity on any curl_multi connection * @link https://php.net/manual/en/function.curl-multi-select.php * @param CurlMultiHandle|resource $multi_handle * @param float $timeout [optional] * Time, in seconds, to wait for a response. * * @return int On success, returns the number of descriptors contained in, * the descriptor sets. On failure, this function will return -1 on a select failure or timeout (from the underlying select system call). */ function curl_multi_select(#[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] $multi_handle, float $timeout = 1.0): int {} /** * (PHP 5 >=5.5.0) * Set an option for the cURL multi handle * @link https://secure.php.net/manual/en/function.curl-multi-setopt.php * @param CurlMultiHandle|resource $multi_handle * @param int $option * One of the CURLMOPT_* constants. * * @param mixed $value * The value to be set on option. * * * value should be an {@link https://php.net/manual/en/language.types.integer.php int} for the * following values of the option parameter: * <table> * * <thead> * <tr> * <th>Option</th> * <th>Set <code class="parameter">value</code> to</th> * </tr> * </thead> * * <tbody> * <tr> * <td>CURLMOPT_PIPELINING</td> * <td style="vertical-align: top;"> * Pass 1 to enable or 0 to disable. Enabling pipelining on a multi * handle will make it attempt to perform HTTP Pipelining as far as * possible for transfers using this handle. This means that if you add * a second request that can use an already existing connection, the * second request will be "piped" on the same connection rather than * being executed in parallel. * </td> * </tr> * * <tr> * <td style="vertical-align: top;">CURLMOPT_MAXCONNECTS</td> * <td style="vertical-align: top;"> * Pass a number that will be used as the maximum amount of * simultaneously open connections that libcurl may cache. Default is * 10. When the cache is full, curl closes the oldest one in the cache * to prevent the number of open connections from increasing. * </td> * </tr> * </tbody> * </table> * @return bool Returns TRUE on success or FALSE on failure. * @since 5.5 */ function curl_multi_setopt(#[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] $multi_handle, int $option, mixed $value): bool {} /** * (PHP 5 >=5.5.0) * Return string describing error code * @link https://secure.php.net/manual/en/function.curl-multi-strerror.php * @param int $error_code * One of the {@link https://curl.haxx.se/libcurl/c/libcurl-errors.html CURLM error codes} constants. * * @return string|null Returns error string for valid error code, NULL otherwise. * @since 5.5 */ function curl_multi_strerror(int $error_code): ?string {} /** * (PHP 5 >=5.5.0) * Pause and unpause a connection * @link https://secure.php.net/manual/en/function.curl-pause.php * @param CurlHandle|resource $handle * A cURL handle returned by {@link https://secure.php.net/manual/en/function.curl-init.php curl_init()}. * @param int $flags One of CURLPAUSE_* constants. * @return int Returns an error code (CURLE_OK for no error). * @since 5.5 */ function curl_pause(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle, int $flags): int {} /** * (PHP 5 >=5.5.0) * Reset all options of a libcurl session handle * @link https://secure.php.net/manual/en/function.curl-reset.php * @param CurlHandle|resource $handle A cURL handle returned by * {@link https://secure.php.net/manual/en/function.curl-init.php curl_init()}. * @return void * @since 5.5 */ function curl_reset(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle): void {} /** * Run the sub-connections of the current cURL handle * @link https://php.net/manual/en/function.curl-multi-exec.php * @param CurlMultiHandle|resource $multi_handle * @param int &$still_running * A reference to a flag to tell whether the operations are still running. * * @return int A cURL code defined in the cURL Predefined Constants. * * This only returns errors regarding the whole multi stack. There might still have * occurred problems on individual transfers even when this function returns * CURLM_OK. * */ function curl_multi_exec( #[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] $multi_handle, #[PhpStormStubsElementAvailable(from: '5.3', to: '7.4')] &$still_running = 0, #[PhpStormStubsElementAvailable(from: '8.0')] &$still_running ): int {} /** * Return the content of a cURL handle if <constant>CURLOPT_RETURNTRANSFER</constant> is set * @link https://php.net/manual/en/function.curl-multi-getcontent.php * @param CurlHandle|resource $handle * @return null|string Return the content of a cURL handle if CURLOPT_RETURNTRANSFER is set. */ #[Pure] function curl_multi_getcontent(#[LanguageLevelTypeAware(['8.0' => 'CurlHandle'], default: 'resource')] $handle): ?string {} /** * Get information about the current transfers * @link https://php.net/manual/en/function.curl-multi-info-read.php * @param CurlMultiHandle|resource $multi_handle * @param int &$queued_messages [optional] * Number of messages that are still in the queue * * @return array|false On success, returns an associative array for the message, false on failure. */ #[Pure] #[ArrayShape(["msg" => "int", "result" => "int", "handle" => "resource"])] function curl_multi_info_read(#[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] $multi_handle, &$queued_messages): array|false {} /** * Close a set of cURL handles * @link https://php.net/manual/en/function.curl-multi-close.php * @param CurlMultiHandle|resource $multi_handle * @return void */ function curl_multi_close(#[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] $multi_handle): void {} /** * Return the last multi curl error number * @param CurlMultiHandle|resource $multi_handle * @return int * @since 7.1 */ #[Pure(true)] function curl_multi_errno(#[LanguageLevelTypeAware(['8.0' => 'CurlMultiHandle'], default: 'resource')] $multi_handle): int {} /** * Return the last share curl error number * @param CurlMultiHandle|resource $share_handle * @return int * @since 7.1 */ #[Pure(true)] function curl_share_errno(#[LanguageLevelTypeAware(['8.0' => 'CurlShareHandle'], default: 'resource')] $share_handle): int {} /** * Return string describing the given error code * @param int $error_code * @return string|null * @since 7.1 */ #[Pure] function curl_share_strerror(int $error_code): ?string {} /** * @since 8.2 */ function curl_upkeep(CurlHandle $handle): bool {} /** * @since 8.0 */ final class CurlHandle { /** * Cannot directly construct CurlHandle, use curl_init() instead * @see curl_init() */ private function __construct() {} } /** * @since 8.0 */ final class CurlMultiHandle { /** * Cannot directly construct CurlMultiHandle, use curl_multi_init() instead * @see curl_multi_init() */ private function __construct() {} } /** * @since 8.0 */ final class CurlShareHandle { /** * Cannot directly construct CurlShareHandle, use curl_share_init() instead * @see curl_share_init() */ private function __construct() {} }

Parece que el enlace que apuntaba aquí no sirve. ¿Quieres probar con una búsqueda?

Parece que esta página no existe.

Entradas recientes

Horarios

Donde estamos

Síguenos