@ZouChao

热爱PHP,RUBY,专注于web开发. 一个忠实于内心的平凡人

PHP中的CURL函数库(Client URL Library Function)

  • 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.baidu.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.baidu.com/");
print_r(curl_getinfo($ch));
可选的常量包括:
  1. CURLINFO_EFFECTIVE_URL 最后一个有效的url地址
  2. CURLINFO_HTTP_CODE 最后一个收到的HTTP代码
  3. CURLINFO_FILETIME 远程获取文档的时间,如果无法获取,则返回值为“-1”
  4. CURLINFO_TOTAL_TIME 最后一次传输所消耗的时间
  5. CURLINFO_NAMELOOKUP_TIME 名称解析所消耗的时间
  6. CURLINFO_CONNECT_TIME 建立连接所消耗的时间
  7. CURLINFO_PRETRANSFER_TIME 从建立连接到准备传输所使用的时间
  8. CURLINFO_STARTTRANSFER_TIME 从建立连接到传输开始所使用的时间
  9. CURLINFO_REDIRECT_TIME 在事务传输开始前重定向所使用的时间
  10. CURLINFO_SIZE_UPLOAD 上传数据量的总值
  11. CURLINFO_SIZE_DOWNLOAD 下载数据量的总值
  12. CURLINFO_SPEED_DOWNLOAD 平均下载速度
  13. CURLINFO_SPEED_UPLOAD 平均上传速度
  14. CURLINFO_HEADER_SIZE header部分的大小
  15. CURLINFO_HEADER_OUT 发送请求的字符串
  16. CURLINFO_REQUEST_SIZE 在HTTP请求中有问题的请求的大小
  17. CURLINFO_SSL_VERIFYRESULT Result of SSL certification verification requested by setting CURLOPT_SSL_VERIFYPEER
  18. CURLINFO_CONTENT_LENGTH_DOWNLOAD 从Content-Length: field中读取的下载内容长度
  19. CURLINFO_CONTENT_LENGTH_UPLOAD 上传内容大小的说明
  20. 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.baidu.com/',
  CURLOPT_HEADER => false
);
curl_setopt_array($ch, $options);
curl_exec($ch);
curl_close($ch);
fclose($fp);
可设置的参数有:
  1. CURLOPT_AUTOREFERER 自动设置header中的referer信息
  2. CURLOPT_BINARYTRANSFER 在启用CURLOPT_RETURNTRANSFER时候将获取数据返回
  3. CURLOPT_COOKIESESSION 启用时curl会仅仅传递一个session cookie,忽略其他的cookie,默认状况下curl会将所有的cookie返回给服务端。session cookie是指那些用来判断服务器端的session是否有效而存在的cookie。
  4. CURLOPT_CRLF 启用时将Unix的换行符转换成回车换行符。
  5. CURLOPT_DNS_USE_GLOBAL_CACHE 启用时会启用一个全局的DNS缓存,此项为线程安全的,并且默认为true。
  6. CURLOPT_FAILONERROR 显示HTTP状态码,默认行为是忽略编号小于等于400的HTTP信息
  7. CURLOPT_FILETIME 启用时会尝试修改远程文档中的信息。结果信息会通过curl_getinfo()函数的CURLINFO_FILETIME选项返回。
  8. CURLOPT_FOLLOWLOCATION 启用时会将服务器服务器返回的“Location:”放在header中递归的返回给服务器,使用CURLOPT_MAXREDIRS可以限定递归返回的数量。
  9. CURLOPT_FORBID_REUSE 在完成交互以后强迫断开连接,不能重用。
  10. CURLOPT_FRESH_CONNECT 强制获取一个新的连接,替代缓存中的连接。
  11. 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.
  12. 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.
  13. CURLOPT_FTPAPPEND TRUE to append to the remote file instead of overwriting it.
  14. CURLOPT_FTPASCII An alias of CURLOPT_TRANSFERTEXT+ Use that instead.
  15. CURLOPT_FTPLISTONLY TRUE to only list the names of an FTP directory.
  16. CURLOPT_HEADER 启用时会将头文件的信息作为数据流输出。
  17. CURLOPT_HTTPGET 启用时会设置HTTP的method为GET,因为GET是默认是,所以只在被修改的情况下使用。
  18. CURLOPT_HTTPPROXYTUNNEL 启用时会通过HTTP代理来传输。
  19. CURLOPT_MUTE 讲curl函数中所有修改过的参数恢复默认值。
  20. CURLOPT_NETRC 在连接建立以后,访问~/.netrc文件获取用户名和密码信息连接远程站点。
  21. CURLOPT_NOBODY 启用时将不对HTML中的body部分进行输出。
  22. CURLOPT_NOPROGRESS 启用时关闭curl传输的进度条,此项的默认设置为true
  23. CURLOPT_NOSIGNAL 启用时忽略所有的curl传递给php进行的信号。在SAPI多线程传输时此项被默认打开。
  24. CURLOPT_POST 启用时会发送一个常规的POST请求,类型为:application/x-www-form-urlencoded,就像表单提交的一样。
  25. CURLOPT_PUT 启用时允许HTTP发送文件,必须同时设置CURLOPT_INFILE和CURLOPT_INFILESIZE
  26. CURLOPT_RETURNTRANSFER 讲curl_exec()获取的信息以文件流的形式返回,而不是直接输出。
  27. 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.+ Default bundle installed as of cURL 7.10.
  28. 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.
  29. CURLOPT_UNRESTRICTED_AUTH 在使用CURLOPT_FOLLOWLOCATION产生的header中的多个locations中持续追加用户名和密码信息,即使域名已发生改变。
  30. CURLOPT_UPLOAD 启用时允许文件传输
  31. CURLOPT_VERBOSE 启用时会汇报所有的信息,存放在STDERR或指定的CURLOPT_STDERR中
  32. CURLOPT_BUFFERSIZE 每次获取的数据中读入缓存的大小,这个值每次都会被填满。
  33. CURLOPT_CLOSEPOLICY 不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST,还存在另外三个,但是curl暂时还不支持。.
  34. CURLOPT_CONNECTTIMEOUT 在发起连接前等待的时间,如果设置为0,则不等待。
  35. CURLOPT_DNS_CACHE_TIMEOUT 设置在内存中保存DNS信息的时间,默认为120秒。
  36. 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).
  37. 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)
  38. 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
  39. CURLOPT_INFILESIZE 设定上传文件的大小
  40. CURLOPT_LOW_SPEED_LIMIT 当传输速度小于CURLOPT_LOW_SPEED_LIMIT时,PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输。
  41. 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.
  42. 当传输速度小于CURLOPT_LOW_SPEED_LIMIT时,PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输。
  43. CURLOPT_MAXCONNECTS 允许的最大连接数量,超过是会通过CURLOPT_CLOSEPOLICY决定应该停止哪些连接
  44. CURLOPT_MAXREDIRS 指定最多的HTTP重定向的数量,这个选项是和CURLOPT_FOLLOWLOCATION一起使用的。
  45. CURLOPT_PORT 一个可选的用来指定连接端口的量
  46. 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.
  47. CURLOPT_PROXYPORT The port number of the proxy to connect to+ This port number can also be set in CURLOPT_PROXY.
  48. CURLOPT_PROXYTYPE Either CURLPROXY_HTTP (default) or CURLPROXY_SOCKS5.
  49. CURLOPT_RESUME_FROM 在恢复传输时传递一个字节偏移量(用来断点续传)
  50. 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.
  51. 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.
  52. CURLOPT_TIMECONDITION 如果在CURLOPT_TIMEVALUE指定的某个时间以后被编辑过,则使用CURL_TIMECOND_IFMODSINCE返回页面,如果没有被修改过,并且CURLOPT_HEADER为true,则返回一个”304 Not Modified”的header,CURLOPT_HEADER为false,则使用CURL_TIMECOND_ISUNMODSINCE,默认值为CURL_TIMECOND_IFMODSINCE
  53. CURLOPT_TIMEOUT 设置curl允许执行的最长秒数
  54. CURLOPT_TIMEVALUE 设置一个CURLOPT_TIMECONDITION使用的时间戳,在默认状态下使用的是CURL_TIMECOND_IFMODSINCE
  55. 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.
  56. CURLOPT_CAPATH A directory that holds multiple CA certificates+ Use this option alongside CURLOPT_SSL_VERIFYPEER.
  57. CURLOPT_COOKIE 设定HTTP请求中“Set-Cookie:”部分的内容。
  58. CURLOPT_COOKIEFILE 包含cookie信息的文件名称,这个cookie文件可以是Netscape格式或者HTTP风格的header信息。
  59. CURLOPT_COOKIEJAR 连接关闭以后,存放cookie信息的文件名称
  60. 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.
  61. Note: Don’t do this without making sure the server supports the custom request method first.
  62. CURLOPT_EGBSOCKET Like CURLOPT_RANDOM_FILE, except a filename to an Entropy Gathering Daemon socket.
  63. CURLOPT_ENCODING header中“Accept-Encoding: ”部分的内容,支持的编码格式为:”identity”,”deflate”,”gzip”。如果设置为空字符串,则表示支持所有的编码格式
  64. 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.
  65. CURLOPT_INTERFACE 在外部网络接口中使用的名称,可以是一个接口名,IP或者主机名。
  66. CURLOPT_KRB4LEVEL KRB4(Kerberos 4)安全级别的设置,可以是一下几个值之一:”clear”,”safe”,”confidential”,”private”。默认的值为”private”,设置为null的时候表示禁用KRB4,现在KRB4安全仅能在FTP传输中使用。
  67. CURLOPT_POSTFIELDS 在HTTP中的“POST”操作。如果要传送一个文件,需要一个@开头的文件名
  68. CURLOPT_PROXY 设置通过的HTTP代理服务器
  69. CURLOPT_PROXYUSERPWD 连接到代理服务器的,格式为“[username]:[password]”的用户名和密码。
  70. CURLOPT_RANDOM_FILE 设定存放SSL用到的随机数种子的文件名称
  71. CURLOPT_RANGE 设置HTTP传输范围,可以用“X-Y”的形式设置一个传输区间,如果有多个HTTP传输,则使用逗号分隔多个值,形如:”X-Y,N-M”。
  72. CURLOPT_REFERER 设置header中”Referer: “ 部分的值。
  73. CURLOPT_SSL_CIPHER_LIST A list of ciphers to use for SSL+ For example, RC4-SHA and TLSv1 are valid cipher lists.
  74. CURLOPT_SSLCERT 传递一个包含PEM格式证书的字符串。
  75. CURLOPT_SSLCERTPASSWD 传递一个包含使用CURLOPT_SSLCERT证书必需的密码。
  76. CURLOPT_SSLCERTTYPE The format of the certificate+ Supported formats are “PEM” (default), “DER”, and “ENG”.
  77. CURLOPT_SSLENGINE The identifier for the crypto engine of the private SSL key specified in CURLOPT_SSLKEY.
  78. CURLOPT_SSLENGINE_DEFAULT The identifier for the crypto engine used for asymmetric crypto operations.
  79. CURLOPT_SSLKEY The name of a file containing a private SSL key.
  80. 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.
  81. CURLOPT_SSLKEYTYPE The key type of the private SSL key specified in CURLOPT_SSLKEY+ Supported key types are “PEM” (default), “DER”, and “ENG”.
  82. CURLOPT_URL 需要获取的URL地址,也可以在PHP的curl_init()函数中设置。
  83. CURLOPT_USERAGENT 在HTTP请求中包含一个”user-agent”头的字符串。
  84. CURLOPT_USERPWD 传递一个连接中需要的用户名和密码,格式为:“[username]:[password]”。
  85. CURLOPT_HTTP200ALIASES 设置不再以error的形式来处理HTTP 200的响应,格式为一个数组。
  86. CURLOPT_HTTPHEADER 设置一个header中传输内容的数组。
  87. CURLOPT_POSTQUOTE An array of FTP commands to execute on the server after the FTP request has been performed.
  88. CURLOPT_QUOTE An array of FTP commands to execute on the server prior to the FTP request.
  89. CURLOPT_FILE 设置输出文件的位置,值是一个资源类型,默认为STDOUT (浏览器)。
  90. CURLOPT_INFILE 在上传文件的时候需要读取的文件地址,值是一个资源类型。
  91. CURLOPT_STDERR 设置一个错误输出地址,值是一个资源类型,取代默认的STDERR。
  92. CURLOPT_WRITEHEADER 设置header部分内容的写入的文件地址,值是一个资源类型。
  93. CURLOPT_HEADERFUNCTION 设置一个回调函数,这个函数有两个参数,第一个是curl的资源句柄,第二个是输出的header数据。header数据的输出必须依赖这个函数,返回已写入的数据大小。
  94. CURLOPT_PASSWDFUNCTION 设置一个回调函数,有三个参数,第一个是curl的资源句柄,第二个是一个密码提示符,第三个参数是密码长度允许的最大值。返回密码的值。
  95. CURLOPT_READFUNCTION 设置一个回调函数,有两个参数,第一个是curl的资源句柄,第二个是读取到的数据。数据读取必须依赖这个函数。返回读取数据的大小,比如0或者EOF。
  96. CURLOPT_WRITEFUNCTION 设置一个回调函数,有两个参数,第一个是curl的资源句柄,第二个是写入的数据。数据写入必须依赖这个函数。返回精确的已写入数据的大小
  • curl_copy_handle()函数的作用是拷贝一个curl连接资源的所有内容和参数
$ch = curl_init("http://www.baidu.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.baidu.com/");
curl_setopt($ch1, CURLOPT_HEADER, 0);
curl_setopt($ch2, CURLOPT_URL, "http://www.google.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”
 转载自 CURL详解 | Andy's Blog