PHP CURL函数参数详尽中文说明（附实例）

关于 CURL 函数各项使用参数的中文说明:

bool curl_setopt (int ch, string option, mixed value)

curl_setopt()函数将为一个 CURL 会话设置选项。option 参数是你想要的设置，value 是这个选项给定的值。

下列选项的值将被作为长整形使用(在 option 参数中指定)：

  • CURLOPT_INFILESIZE: 当你上传一个文件到远程站点，这个选项告诉 PHP 你上传文件的大小。

  • CURLOPT_VERBOSE: 如果你想 CURL 报告每一件意中的事情，设置这个选项为一个非零值。

  • CURLOPT_HEADER: 如果你想把一个头包含在输出中，设置这个选项为一个非零值。

  • CURLOPT_NOPROGRESS: 如果你不会 PHP 为 CURL 传输显示一个进程条，设置这个选项为一个非零值。注意：PHP 自动设置这个选项为非零值，你应该仅仅为了调试的目的来改变这个选项。

  • CURLOPT_NOBODY: 如果你不想在输出中包含 body 部分，设置这个选项为一个非零值。

  • CURLOPT_FAILONERROR: 如果你想让 PHP 在发生错误(HTTP 代码返回大于即是 300)时，不显示，设置这个选项为一人非零值。默认行为是返回一个正常页，忽略代码。

  • CURLOPT_UPLOAD: 如果你想让 PHP 为上传做预备，设置这个选项为一个非零值。

  • CURLOPT_POST: 如果你想 PHP 去做一个正规的 HTTP POST，设置这个选项为一个非零值。这个 POST 是普通的 application/x-www-from-urlencoded 类型，多数被 HTML 表单使用。

  • CURLOPT_FTPLISTONLY: 设置这个选项为非零值，PHP 将列出 FTP 的目录名列表。

  • CURLOPT_FTPAPPEND: 设置这个选项为一个非零值，PHP 将应用远程文件代替覆盖它。

  • CURLOPT_NETRC: 设置这个选项为一个非零值，PHP 将在你的 ~./netrc 文件中查找你要建立连接的远程站点的用户名及密码。

  • CURLOPT_FOLLOWLOCATION: 设置这个选项为一个非零值(象 “Location: “)的头，服务器会把它当做 HTTP 头的一部分发送(注意这是递归的，PHP 将发送形如 “Location: “的头)。

  • CURLOPT_PUT: 设置这个选项为一个非零值去用 HTTP 上传一个文件。要上传这个文件必须设置 CURLOPT_INFILE 和 CURLOPT_INFILESIZE 选项.

  • CURLOPT_MUTE: 设置这个选项为一个非零值，PHP 对于 CURL 函数将完全沉默。

  • CURLOPT_TIMEOUT: 设置一个长整形数，作为最大延续多少秒。

  • CURLOPT_LOW_SPEED_LIMIT: 设置一个长整形数，控制传送多少字节。

  • CURLOPT_LOW_SPEED_TIME: 设置一个长整形数，控制多少秒传送 CURLOPT_LOW_SPEED_LIMIT 规定的字节数。

  • CURLOPT_RESUME_FROM: 传递一个包含字节偏移地址的长整形参数，(你想转移到的开始表单)。

  • CURLOPT_SSLVERSION: 传递一个包含 SSL 版本的长参数。默认 PHP 将被它自己起劲的确定，在更多的安全中你必须手工设置。

  • CURLOPT_TIMECONDITION: 传递一个长参数，指定怎么处置惩罚 CURLOPT_TIMEVALUE 参数。你可以设置这个参数为 TIMECOND_IFMODSINCE 或 TIMECOND_ISUNMODSINCE。这仅用于 HTTP。

  • CURLOPT_TIMEVALUE: 传递一个从 1970-1-1 开始到现在的秒数。这个时间将被 CURLOPT_TIMEVALUE 选项作为指定值使用，或被默认 TIMECOND_IFMODSINCE 使用。

下列选项的值将被作为字符串：

  • CURLOPT_URL: 这是你想用 PHP 取回的 URL 地址。你也可以在用 curl_init()函数初始化时设置这个选项。

  • CURLOPT_USERPWD: 传递一个形如[username]:[password]风格的字符串,作用 PHP 去连接。

  • CURLOPT_PROXYUSERPWD: 传递一个形如[username]:[password] 格式的字符串去连接 HTTP 代理。

  • CURLOPT_RANGE: 传递一个你想指定的范围。它应该是”X-Y”格式，X 或 Y 是被除中的。HTTP 传送同样支持几个间隔，用逗句来分隔(X-Y,N-M)。

  • CURLOPT_POSTFIELDS: 传递一个作为 HTTP “POST”操作的所有数据的字符串。

  • CURLOPT_REFERER: 在 HTTP 请求中包含一个”referer”头的字符串。

  • CURLOPT_USERAGENT: 在 HTTP 请求中包含一个”user-agent”头的字符串。

  • CURLOPT_FTPPORT: 传递一个包含被 ftp “POST”指令使用的 IP 地址。这个 POST 指令告诉远程服务器去连接我们指定的 IP 地址。这个字符串可以是一个 IP 地址，一个主机名，一个网络界面名(在 UNIX 下)，或是‘-’(使用系统默认 IP 地址)。

  • CURLOPT_COOKIE: 传递一个包含 HTTP cookie 的头连接。

  • CURLOPT_SSLCERT: 传递一个包含 PEM 格式证书的字符串。

  • CURLOPT_SSLCERTPASSWD: 传递一个包含使用 CURLOPT_SSLCERT 证书必需的密码。

  • CURLOPT_COOKIEFILE: 传递一个包含 cookie 数据的文件的名字的字符串。这个 cookie 文件可以是 Netscape 格式，或是堆存在文件中的 HTTP 风格的头。

  • CURLOPT_CUSTOMREQUEST: 当进行 HTTP 请求时，传递一个字符被 GET 或 HEAD 使用。为进行 DELETE 或其它操作是有益的，更 Pass a string to be used instead of GET or HEAD when doing an HTTP request. This is useful for doing or another, more obscure, HTTP request. 注意: 在确认你的服务器支持命令先不要去这样做。资源分享下列的选项要求一个文件描写(通过使用 fopen()函数获得)：

  • CURLOPT_FILE: 这个文件将是你放置传送的输出文件，默认是 STDOUT.

  • CURLOPT_INFILE: 这个文件是你传送过来的输入文件。

  • CURLOPT_WRITEHEADER: 这个文件写有你输出的头部分。

  • CURLOPT_STDERR: 这个文件写有错误而不是 stderr。用来获取需要登录的页面的例子,当前做法是每次或许都登录一次,有需要的人再做改进了.

下面用实例为大家讲解一下用法:

例一：模拟登录（提交用户名和密码后将 cookie 保存起来）

$cookie_jar = tempnam('./tmp','cookie');
$ch = curl_init();
curl_setopt($ch,CURLOPT_URL, 'http://www.gamer5.com');
curl_setopt($ch, CURLOPT_POST, 1);
$request = 'email_address=&password=&action=';
curl_setopt($ch, CURLOPT_POSTFIELDS, $request);
//把返回来的cookie信息保存在$cookie_jar文件中
curl_setopt($ch, CURLOPT_COOKIEJAR, $cookie_jar);
//设定返回的数据是否自动显示
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
//设定是否显示头信息
curl_setopt($ch, CURLOPT_HEADER, false);
//设定是否输出页面内容
curl_setopt($ch, CURLOPT_NOBODY, false);
curl_exec($ch);
curl_close($ch);

例二：模拟登录之后要干的事（使用例一中所取得的 cookie 发出请求）

$ch2 = curl_init();
curl_setopt($ch2, CURLOPT_URL, 'http://www.coserfan.com');
curl_setopt($ch2, CURLOPT_HEADER, false);
curl_setopt($ch2, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch2, CURLOPT_COOKIEFILE, $cookie_jar);
$orders = curl_exec($ch2);
echo "";
echo strip_tags($orders);
echo "";
curl_close($ch2);

例三：模拟 Session（注意 Session 的本质是通过读取 Cookie 中保存的 SessionID 来确定的）

set_time_limit(0);
function _rand() {
    $length=26;
    $chars = “0abcdefghijklmnopqrstuvwxyz”;
    $max = strlen($chars) – 1;
    mt_srand((double)microtime() * );
    $string = ”;
    for($i = 0; $i < $length; $i++) {
        $string .= $chars[mt_rand(0, $max)];
    }
    return $string;
}

$HTTP_SESSION=_rand();
echo $HTTP_SESSION;

$HTTP_Server="www.htmltec.com";
$HTTP_URL="/";
$ch = curl_init();
curl_setopt ($ch,CURLOPT_URL,"http://".$HTTP_Server.$HTTP_URL);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch,CURLOPT_USERAGENT,"Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.)");
curl_setopt($ch,CURLOPT_COOKIE,$HTTP_SESSION);
$res = curl_exec($ch);
curl_close ($ch);
print_r($res);

例四：刷论坛代码

1、抓 cookies 程序：

$URL="http://www.coserfan.com/"."bbs/login.asp?action=chk";
//填入论坛的登陆页面地址
$ch = curl_init();
curl_setopt($ch,CURLOPT_URL,$URL);
curl_setopt($ch,CURLOPT_REFERER,"http://www.coserfan.com"."/bbs/login.asp");
//设置，访问页面的来源地址
curl_setopt($ch,CURLOPT_POST,1);
curl_setopt($ch,CURLOPT_POSTFIELDS,'username=→→敢死队→&password=');
//分析登陆页面，把用户名，密码分别对应起来
curl_setopt ($ch, CURLOPT_HEADER,true);
//使能显示http头，
curl_exec($ch);
if (curl_errno($ch))
{
    print curl_error($ch);
}
else
{
    curl_close($ch);
}

2、刷楼了：

set_time_limit(0);//设置程序执行时间无限制
$i=100;//设置要刷多少楼
for($j=0;$j<$i;$j++)
{
    $URL="http://www.coserfan.com"."/bbs/savepost.asp";
    //这个地址是回复表单里面action的url地址
    $ch = curl_init();
    curl_setopt($ch,CURLOPT_URL,$URL);
    curl_setopt($ch,CURLOPT_REFERER,"http://www.coserfan.com"."/bbs/dispbbs.asp?boardid=14&replyid=&id=&page=1&skin=0&Star=53");
    //设置来源地址，如果不设置，论坛服务器有可能有验证不允许回复
    curl_setopt($ch,CURLOPT_COOKIESESSION,true);
    //能保存cookie
    curl_setopt($ch,CURLOPT_COOKIE,"DvForum=userid=&usercookies=0&userhidden=2&password=w0reu3g775VrY745&userclass=%96%7C&username=%A1%FA%A1%FA%B8%D2%CB%C0%B6%D3%A1%FA&StatUserID= ");
    //这儿就是设置cookie了
    curl_setopt($ch,CURLOPT_POST,1);
    curl_setopt($ch,CURLOPT_NOBODY,1);
    //不显示内容，因为有很多论坛回复后要自动跳转。
    curl_setopt($ch,CURLOPT_POSTFIELDS,'Body=gfdfgdfgasdfgdfgdfgdfg& followup=&RootID=&star=58&TotalUseTable=Dv_bbs3& amp;UserName=→→敢死队→&signflag=1&total=');
    //把你分析的回复表单的参数分别赋值
    curl_setopt ($ch, CURLOPT_HEADER,true);
    curl_exec($ch);
    if (curl_errno($ch))
    {
        print curl_error($ch);
    } else {
        curl_close($ch);
    }
}

CURL 的其他高级方法 curl_close — 关闭一个 curl 会话

curl_copy_handle — 拷贝一个 curl 连接资源的所有内容和参数

curl_errno — 返回一个包含当前会话错误信息的数字编号

curl_error — 返回一个包含当前会话错误信息的字符串

curl_exec — 执行一个 curl 会话

curl_getinfo — 获取一个 curl 连接资源句柄的信息

curl_init — 初始化一个 curl 会话

curl_multi_add_handle — 向 curl 批处理会话中添加单独的 curl 句柄资源

curl_multi_close — 关闭一个批处理句柄资源

curl_multi_exec — 解析一个 curl 批处理句柄

curl_multi_getcontent — 返回获取的输出的文本流

curl_multi_info_read — 获取当前解析的 curl 的相关传输信息

curl_multi_init — 初始化一个 curl 批处理句柄资源

curl_multi_remove_handle — 移除 curl 批处理句柄资源中的某个句柄资源

curl_multi_select — Get all the sockets associated with the cURL extension, which can then be “selected”

curl_setopt_array — 以数组的形式为一个 curl 设置会话参数

curl_setopt — 为一个 curl 设置会话参数

curl_version — 获取 curl 相关的版本信息

curl_init()函数的作用初始化一个 curl 会话，curl_init()函数唯一的一个参数是可选的，表示一个 url 地址。

curl_exec()函数的作用是执行一个 curl 会话，唯一的参数是 curl_init()函数返回的句柄。

curl_close()函数的作用是关闭一个 curl 会话，唯一的参数是 curl_init()函数返回的句柄。

$ch = curl_init("http://www.coserfan.com/");
curl_exec($ch);
curl_close($ch);

curl_version()函数的作用是获取 curl 相关的版本信息，curl_version()函数有一个参数，不清楚是做什么的

print_r(curl_version())

curl_getinfo()函数的作用是获取一个 curl 连接资源句柄的信息，curl_getinfo()函数有两个参数，第一个参数是 curl 的资源句柄，第二个参数是下面一些常量：

$ch = curl_init("http://www.coserfan.com/");
print_r(curl_getinfo($ch));

可选的常量包括：

CURLINFO_EFFECTIVE_URL

最后一个有效的 url 地址

CURLINFO_HTTP_CODE

最后一个收到的 HTTP 代码

CURLINFO_FILETIME

远程获取文档的时间，如果无法获取，则返回值为“-1”

CURLINFO_TOTAL_TIME

最后一次传输所消耗的时间

CURLINFO_NAMELOOKUP_TIME

名称解析所消耗的时间

CURLINFO_CONNECT_TIME

建立连接所消耗的时间

CURLINFO_PRETRANSFER_TIME

从建立连接到预备传输所使用的时间

CURLINFO_STARTTRANSFER_TIME

从建立连接到传输开始所使用的时间

CURLINFO_REDIRECT_TIME

在事务传输开始前重定向所使用的时间

CURLINFO_SIZE_UPLOAD

上传数据量的总值

CURLINFO_SIZE_DOWNLOAD

下载数据量的总值

CURLINFO_SPEED_DOWNLOAD

平均下载速度

CURLINFO_SPEED_UPLOAD

平均上传速度

CURLINFO_HEADER_SIZE

header 部分的大小

CURLINFO_HEADER_OUT

发送请求的字符串

CURLINFO_REQUEST_SIZE

在 HTTP 请求中有问题的请求的大小

CURLINFO_SSL_VERIFYRESULT

Result of SSL certification verification requested by setting CURLOPT_SSL_VERIFYPEER

CURLINFO_CONTENT_LENGTH_DOWNLOAD

从 Content-Length: field 中读取的下载内容长度

CURLINFO_CONTENT_LENGTH_UPLOAD

上传内容大小的说明

CURLINFO_CONTENT_TYPE

下载内容的“Content-type”值，NULL 表示服务器没有发送有效的“Content-Type: header”

curl_setopt()函数的作用是为一个 curl 设置会话参数。curl_setopt_array()函数的作用是以数组的形式为一个 curl 设置会话参数。

$ch = curl_init();
$fp = fopen("example_homepage.txt", "w");
curl_setopt($ch, CURLOPT_FILE, $fp);
$options = array(
    CURLOPT_URL => ‘http://www.coserfan.com/’,
    CURLOPT_HEADER => false
);
curl_setopt_array($ch, $options);
curl_exec($ch);
curl_close($ch);
fclose($fp);

可设置的参数有：

CURLOPT_AUTOREFERER

自动设置 header 中的 referer 信息

CURLOPT_BINARYTRANSFER

在启用 CURLOPT_RETURNTRANSFER 时候将获取数据返回

CURLOPT_COOKIESESSION

启用时 curl 会仅仅传递一个 session cookie，忽略其他的 cookie，默认状况下 curl 会将所有的 cookie 返回给服务端。session cookie 是指那些用来判断服务器端的 session 是否有效而存在的 cookie。

CURLOPT_CRLF

启用时将 Unix 的换行符转换成回车换行符。

CURLOPT_DNS_USE_GLOBAL_CACHE

启用时会启用一个全局的 DNS 缓存，此项为线程安全的，并且默认为 true。

CURLOPT_FAILONERROR

显示 HTTP 状态码，默认行为是忽略编号小于即是 400 的 HTTP 信息

CURLOPT_FILETIME

启用时会尝试修改远程文档中的信息。结果信息会通过 curl_getinfo()函数的 CURLINFO_FILETIME 选项返回。

CURLOPT_FOLLOWLOCATION

启用时会将服务器服务器返回的“Location:”放在 header 中递归的返回给服务器，使用 CURLOPT_MAXREDIRS 可以限定递归返回的数目。

CURLOPT_FORBID_REUSE

在完成交互以后强迫断开连接，不克不及重用。

CURLOPT_FRESH_CONNECT

强制获取一个新的连接，替代缓存中的连接。

CURLOPT_FTP_USE_EPRT

TRUE to use EPRT (and LPRT) when doing active FTP downloads. Use FALSE to disable EPRT and LPRT and use PORT only.

Added in PHP 5.0.0.

CURLOPT_FTP_USE_EPSV

TRUE to first try an EPSV command for FTP transfers before reverting back to PASV. Set to FALSE to disable EPSV.

CURLOPT_FTPAPPEND

TRUE to append to the remote file instead of overwriting it.

CURLOPT_FTPASCII

An alias of CURLOPT_TRANSFERTEXT. Use that instead.

CURLOPT_FTPLISTONLY

TRUE to only list the names of an FTP directory.

CURLOPT_HEADER

启用时会将头文件的信息作为数据流输出。

CURLOPT_HTTPGET

启用时会设置 HTTP 的 method 为 GET，轻型井点降水因为 GET 是默认是，所以只在被修改的情况下使用。

CURLOPT_HTTPPROXYTUNNEL

启用时会通过 HTTP 代理来传输。

CURLOPT_MUTE

讲 curl 函数中所有修悔改的参数恢复默认值。

CURLOPT_NETRC

在连接建立以后，访问~/.netrc 文件获取用户名和密码信息连接远程站点。

CURLOPT_NOBODY

启用时将不对 HTML 中的 body 部分进行输出。

CURLOPT_NOPROGRESS

启用时关闭 curl 传输的进度条，此项的默认设置为 true

CURLOPT_NOSIGNAL

启用时忽略所有的 curl 传递给 php 进行的旌旗暗记。在 SAPI 多线程传输时此项被默认打开。

CURLOPT_POST

启用时会发送一个常规的 POST 请求，类型为：application/x-www-form-urlencoded，就像表单提交的一样。

CURLOPT_PUT

启用时允许 HTTP 发送文件，必须同时设置 CURLOPT_INFILE 和 CURLOPT_INFILESIZE

CURLOPT_RETURNTRANSFER

讲 curl_exec()获取的信息以文件流的形式返回，而不是直接输出。

CURLOPT_SSL_VERIFYPEER

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. CURLOPT_SSL_VERIFYHOST may also need to be TRUE or FALSE if CURLOPT_SSL_VERIFYPEER is disabled (it defaults to 2). TRUE by default as of cURL 7.10. Default bundle installed as of cURL 7.10.

CURLOPT_TRANSFERTEXT

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.

CURLOPT_UNRESTRICTED_AUTH

在使用 CURLOPT_FOLLOWLOCATION 产生的 header 中的多个 locations 中持续追加用户名和密码信息，即使域名已发生改变。

CURLOPT_UPLOAD

启用时允许文件传输

CURLOPT_VERBOSE

启用时会汇报所有的信息，存放在 STDERR 或指定的 CURLOPT_STDERR 中

CURLOPT_BUFFERSIZE

每次获取的数据中读入缓存的大小，这个值每次都会被填满。

CURLOPT_CLOSEPOLICY

不是 CURLCLOSEPOLICY_LEAST_RECENTLY_USED 就是 CURLCLOSEPOLICY_OLDEST，还存在另中三个，但是 curl 暂时还不支持。.

CURLOPT_CONNECTTIMEOUT

在创议连接前等待的时间，如果设置为 0，则不等待。

CURLOPT_DNS_CACHE_TIMEOUT

设置在内存中保存 DNS 信息的时间，默认为 120 秒。

CURLOPT_FTPSSLAUTH

The FTP authentication method (when is activated): CURLFTPAUTH_SSL (try SSL first), CURLFTPAUTH_TLS (try TLS first), or CURLFTPAUTH_DEFAULT (let cURL decide).

CURLOPT_HTTP_VERSION

设置 curl 使用的 HTTP 协议，CURL_HTTP_VERSION_NONE（让 curl 自己判断），CURL_HTTP_VERSION_1_0（HTTP/1.0），CURL_HTTP_VERSION_1_1（HTTP/1.1）

CURLOPT_HTTPAUTH

使用的 HTTP 验证方法，可选的值有：CURLAUTH_BASIC，CURLAUTH_DIGEST，CURLAUTH_GSSNEGOTIATE，CURLAUTH_NTLM，CURLAUTH_ANY，CURLAUTH_ANYSAFE，可以使用“|”操作符分隔多个值，curl 让服务器选择一个支持最好的值，CURLAUTH_ANY 等价于 CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM，CURLAUTH_ANYSAFE 等价于 CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM

CURLOPT_INFILESIZE

设定上传文件的大小

CURLOPT_LOW_SPEED_LIMIT

当传输速度小于 CURLOPT_LOW_SPEED_LIMIT 时，PHP 会根据 CURLOPT_LOW_SPEED_TIME 来判断是否因太慢而取消传输。斗法修仙传如何加点

CURLOPT_LOW_SPEED_TIME

The number of seconds the transfer should be below CURLOPT_LOW_SPEED_LIMIT for PHP to consider the transfer too slow and abort.

当传输速度小于 CURLOPT_LOW_SPEED_LIMIT 时，PHP 会根据 CURLOPT_LOW_SPEED_TIME 来判断是否因太慢而取消传输。

CURLOPT_MAXCONNECTS

允许的最大连接数目，超过是会通过 CURLOPT_CLOSEPOLICY 决议应该停止哪些连接

CURLOPT_MAXREDIRS

指定最多的 HTTP 重定向的数目，这个选项是和 CURLOPT_FOLLOWLOCATION 一起使用的。

CURLOPT_PORT

一个可选的用来指定连接端口的量

CURLOPT_PROXYAUTH

The HTTP authentication method(s) to use for the proxy connection. Use the same bitmasks as described in CURLOPT_HTTPAUTH. For proxy authentication, only CURLAUTH_BASIC and CURLAUTH_NTLM are currently supported.

CURLOPT_PROXYPORT

The port number of the proxy to connect to. This port number can also be set in CURLOPT_PROXY.

CURLOPT_PROXYTYPE

Either CURLPROXY_HTTP (default) or CURLPROXY_SOCKS5.

CURLOPT_RESUME_FROM

在恢复传输时传递一个字节偏移量（用来断点续传）

CURLOPT_SSL_VERIFYHOST

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.

CURLOPT_SSLVERSION

The SSL version (2 or 3) to use. By default PHP will try to determine this itself, although in some cases this must be set manually.

CURLOPT_TIMECONDITION

如果在 CURLOPT_TIMEVALUE 指定的某个时间以后被编辑过，则使用 CURL_TIMECOND_IFMODSINCE 返回页面，如果没有被修悔改，并且 CURLOPT_HEADER 为 true，则返回一个”304 Not Modified”的 header，CURLOPT_HEADER 为 false，则使用 CURL_TIMECOND_ISUNMODSINCE，默认值为 CURL_TIMECOND_IFMODSINCE

CURLOPT_TIMEOUT

设置 curl 允许执行的最长秒数

CURLOPT_TIMEVALUE

设置一个 CURLOPT_TIMECONDITION 使用的时间戳，在默认状态下使用的是 CURL_TIMECOND_IFMODSINCE

CURLOPT_CAINFO

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.

CURLOPT_CAPATH

A directory that holds multiple CA certificates. Use this option alongside CURLOPT_SSL_VERIFYPEER.

CURLOPT_COOKIE

设定 HTTP 请求中“Set-Cookie:”部分的内容。

CURLOPT_COOKIEFILE

包含 cookie 信息的文件名称，这个 cookie 文件可以是 Netscape 格式或 HTTP 风格的 header 信息。

CURLOPT_COOKIEJAR

连接关闭以后，存放 cookie 信息的文件名称

CURLOPT_CUSTOMREQUEST

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.

Note: Don’t do this without making sure the server supports the custom request method first.

CURLOPT_EGBSOCKET

Like CURLOPT_RANDOM_FILE, except a filename to an Entropy Gathering Daemon socket.

CURLOPT_ENCODING

header 中“Accept-Encoding: ”部分的内容，支持的编码格式为：”identity”，”deflate”，”gzip”。如果设置为空字符串，则表示支持所有的编码格式

CURLOPT_FTPPORT

The value which will be used to get the IP address to use for the FTP “POST” instruction. The “POST” 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.

CURLOPT_INTERFACE

在中部网络接口中使用的名称，可以是一个接口名，IP 或者主机名。

CURLOPT_KRB4LEVEL

KRB4(Kerberos 4)安全级别的设置，可以是一下几个值之一：”clear”，”safe”，”confidential”，”private”。默认的值为”private”，设置为 null 的时候表示禁用 KRB4，现在 KRB4 安全仅能在 FTP 传输中使用。

CURLOPT_POSTFIELDS

在 HTTP 中的“POST”操作。如果要传送一个文件，需要一个@开头的文件名

CURLOPT_PROXY

设置通过的 HTTP 代理服务器

CURLOPT_PROXYUSERPWD

连接到代理服务器的，格式为“[username]:[password]”的用户名和密码。

CURLOPT_RANDOM_FILE

设定存放 SSL 用到的随机数种子的文件名称

CURLOPT_RANGE

设置 HTTP 传输范围，可以用“X-Y”的形式设置一个传输区间，如果有多个 HTTP 传输，则使用逗号分隔多个值，形如：”X-Y,N-M”。

CURLOPT_REFERER

设置 header 中”Referer: ” 部分的值。

CURLOPT_SSL_CIPHER_LIST

A list of ciphers to use for SSL. For example, RC4-SHA and TLSv1 are valid cipher lists.

CURLOPT_SSLCERT

传递一个包含 PEM 格式证书的字符串。

CURLOPT_SSLCERTPASSWD

传递一个包含使用 CURLOPT_SSLCERT 证书必需的密码。

CURLOPT_SSLCERTTYPE

The format of the certificate. Supported formats are “PEM” (default), “DER”, and “ENG”.

CURLOPT_SSLENGINE

The identifier for the crypto engine of the private SSL key specified in CURLOPT_SSLKEY.

CURLOPT_SSLENGINE_DEFAULT

The identifier for the crypto engine used for asymmetric crypto operations.

CURLOPT_SSLKEY

The name of a file containing a private SSL key.

CURLOPT_SSLKEYPASSWD

The secret password needed to use the private SSL key specified in CURLOPT_SSLKEY.

Note: Since this option contains a sensitive password, remember to keep the PHP script it is contained within safe.

CURLOPT_SSLKEYTYPE

The key type of the private SSL key specified in CURLOPT_SSLKEY. Supported key types are “PEM” (default), “DER”, and “ENG”.

CURLOPT_URL

需要获取的 URL 地址，也可以在 PHP 的 curl_init()函数中设置。

CURLOPT_USERAGENT

在 HTTP 请求中包含一个”user-agent”头的字符串。

CURLOPT_USERPWD

传递一个连接中需要的用户名和密码，格式为：“[username]:[password]”www.comqqwww.com。

CURLOPT_HTTP200ALIASES

设置不再以 error 的形式来处理 HTTP 200 的响应，格式为一个数组。

CURLOPT_HTTPHEADER

设置一个 header 中传输内容的数组。

CURLOPT_POSTQUOTE

An array of FTP commands to execute on the server after the FTP request has been performed.

CURLOPT_QUOTE

An array of FTP commands to execute on the server prior to the FTP request.

CURLOPT_FILE

设置输出文件的位置，值是一个资源类型，默认为 STDOUT (浏览器)。

CURLOPT_INFILE

在上传文件的时候需要读取的文件地址，值是一个资源类型。

CURLOPT_STDERR

设置一个错误输出地址，值是一个资源类型，取代默认的 STDERR。

CURLOPT_WRITEHEADER

设置 header 部分内容的写入的文件地址，值是一个资源类型。

CURLOPT_HEADERFUNCTION

设置一个回调函数，这个函数有两个参数，第一个是 curl 的资源句柄，第二个是输出的 header 数据。header 数据的输出必须依赖这个函数，返回已写入的数据大小。

CURLOPT_PASSWDFUNCTION

设置一个回调函数，有三个参数，第一个是 curl 的资源句柄，第二个是一个密码提醒符，第三个参数是密码长度允许的最大值。返回密码的值。

CURLOPT_READFUNCTION

设置一个回调函数，有两个参数，第一个是 curl 的资源句柄，第二个是读取到的数据。数据读取必须依赖这个函数。返回读取数据的大小，比如 0 或者 EOF。

CURLOPT_WRITEFUNCTION

设置一个回调函数，有两个参数，第一个是 curl 的资源句柄，第二个是写入的数据。数据写入必须依赖这个函数。返回精确的已写入数据的大小

curl_copy_handle()函数的作用是拷贝一个 curl 连接资源的所有内容和参数

$ch = curl_init('http://www.coserfan.com');
$another = curl_copy_handle($ch);
curl_exec($another);
curl_close($another);

curl_error()函数的作用是返回一个包含当前会话错误信息的字符串。

curl_errno()函数的作用是返回一个包含当前会话错误信息的数字编号。井冈山酒店推荐

curl_multi_init()函数的作用是初始化一个 curl 批处理句柄资源。

curl_multi_add_handle()函数的作用是向 curl 批处理会话中添加单独的 curl 句柄资源。curl_multi_add_handle()函数有两个参数，第一个参数表示一个 curl 批处理句柄资源，第二个参数表示一个单独的 curl 句柄资源。

curl_multi_exec()函数的作用是解析一个 curl 批处理句柄，curl_multi_exec()函数有两个参数，第一个参数表示一个批处理句柄资源，第二个参数是一个引用值的参数，表示剩余需要处理的单个的 curl 句柄资源数目。

curl_multi_remove_handle()函数表示移除 curl 批处理句柄资源中的某个句柄资源，curl_multi_remove_handle()函数有两个参数，第一个参数表示一个 curl 批处理句柄资源，第二个参数表示一个单独的 curl 句柄资源。

curl_multi_close()函数的作用是关闭一个批处理句柄资源。

$ch1 = curl_init();
$ch2 = curl_init();
curl_setopt($ch1, CURLOPT_URL, 'http://www.coserfan.com');
curl_setopt($ch1, CURLOPT_HEADER, 0);
curl_setopt($ch2, CURLOPT_URL, 'http://www.gamer5.com');
curl_setopt($ch2, CURLOPT_HEADER, 0);
$mh = curl_multi_init();
curl_multi_add_handle($mh,$ch1);
curl_multi_add_handle($mh,$ch2);
do {
    curl_multi_exec($mh,$flag);
} while ($flag > 0);
curl_multi_remove_handle($mh,$ch1);
curl_multi_remove_handle($mh,$ch2);
curl_multi_close($mh);

curl_multi_getcontent()函数的作用是在设置了 CURLOPT_RETURNTRANSFER 的情况下，返回获取的输出的文本流。

curl_multi_info_read()函数的作用是获取当前解析的 curl 的相关传输信息。

curl_multi_select() Get all the sockets associated with the cURL extension, which can then be “selected”

avatar

Software Developer, Open Source Enthusiast and Life Adventurer

FEATURED TAGS
access c-sharp html5 k8s