CURL 宏定义列表
摘自http://blog.csdn.net/msda/article/details/38047809/
CURL 宏定义列表
列表CURL库一共有17个函数
- curl_close:关闭CURL会话
- curl_copy_handle:复制一个CURL会话句柄,同时3复制其所有参数
- curl_errno:返回最后一个错误码
- curl_error:返回一个字符串,用以描述当前会话的最后一个错误
- curl_exec:执行当前会话
- curl_getinfo:获取特定信息
- curl_init:初始化CURL会话
- curl_multi_add_handle:在一个多连接会话中添加一个句柄
- curl_multi_close:关闭一个多句柄CRUL会话
- curl_multi_exec:执行一个多句柄CURL会话
- curl_multi_getcontent:返回一个句柄执行后的内容,如果设置了CURLOPT_RETURNTRANSFER
- curl_multi_info_read:获取当前所有连接的信息
- curl_multi_init:初始化一个多句柄会话
- curl_multi_remove_handle:从一个多句柄会话中删除一个句柄
- curl_multi_select:获取所有绑定的套接字
- curl_setopt:设置CURL传输选项
- curl_version:获取CURL版本
常用设置选项布尔值选项
- CURLOPT_AUTOREFERER:当返回的信息头含有转向信息时,自动设置前向连接
- CURLOPT_BINARYTRANSFER:TRUEtoreturntherawoutputwhenCURLOPT_RETURNTRANSFERisused.
- CURLOPT_COOKIESESSION:标志为新的cookie会话,忽略之前设置的cookie会话
- CURLOPT_CRLF:将Unix系统的换行符转换为Dos换行符
- CURLOPT_DNS_USE_GLOBAL_CACHE:使用全局的DNS缓存
- CURLOPT_FAILONERROR:忽略返回错误
- CURLOPT_FILETIME:获取请求文档的修改日期,该日期可以用curl_getinfo()获取。
- CURLOPT_FOLLOWLOCATION:紧随服务器返回的所有重定向信息
- CURLOPT_FORBID_REUSE:当进程处理完毕后强制关闭会话,不再缓存供重用
- CURLOPT_FRESH_CONNECT:强制建立一个新的会话,而不是重用缓存的会话
- CURLOPT_HEADER:在返回的输出中包含响应头信息
- CURLOPT_HTTPGET:设置HTTP请求方式为GET
- CURLOPT_HTTPPROXYTUNNEL:经由一个HTTP代理建立连接
- CURLOPT_NOBODY:返回的输出中不包含文档信息.
- CURLOPT_NOPROGRESS:禁止进程级别传输,PHP自动设为真
- CURLOPT_NOSIGNAL:忽略所有发往PHP的信息
- CURLOPT_POST:设置POST方式提交数据,POST格式为application/x-www-form-urlencoded
- CURLOPT_PUTTRUE:设置PUT方式上传文件,同时设置CURLOPT_INFILE和CURLOPT_INFILESIZE
- CURLOPT_RETURNTRANSFER:返回字符串,而不是调用curl_exec()后直接输出
- CURLOPT_SSL_VERIFYPEER:SSL验证开启
- CURLOPT_UNRESTRICTED_AUTH:一直链接后面附加用户名和密码,同时设置CURLOPT_FOLLOWLOCATION
- CURLOPT_UPLOAD:准备上传
整数值选项
CURLOPT_BUFFERSIZE:缓存大小
CURLOPT_CONNECTTIMEOUT:连接时间设置,默认0为无限制
CURLOPT_DNS_CACHE_TIMEOUT:内存中保存DNS信息的时间,默认2分钟
CURLOPT_INFILESIZE:上传至远程站点的文件尺寸
CURLOPT_LOW_SPEED_LIMIT:传输最低速度限制andabort.
CURLOPT_LOW_SPEED_TIME:传输时间限制
CURLOPT_MAXCONNECTS:最大持久连接数
CURLOPT_MAXREDIRS:最大转向数
CURLOPT_PORT:连接端口
CURLOPT_PROXYAUTH:代理服务器验证方式
CURLOPT_PROXYPORT:代理服务器端口
CURLOPT_PROXYTYPE:代理服务器类型
CURLOPT_TIMEOUT:CURL函数的最大执行时间
字符串选项
- CURLOPT_COOKIE:HTTP头中set-cookie中的cookie信息
- CURLOPT_COOKIEFILE:包含cookie信息的文件,cookie文件的格式可以是Netscape格式,或者只是HTTP头的格式
- CURLOPT_COOKIEJAR:连接结束后保存cookie信息的文件
- CURLOPT_CUSTOMREQUEST:自定义请求头,使用相对地址
- CURLOPT_ENCODING:HTTP请求头中Accept-Encoding的值
- CURLOPT_POSTFIELDS:POST格式提交的数据内容
- CURLOPT_PROXY:代理通道
- CURLOPT_PROXYUSERPWD:代理认证用户名和密码
- CURLOPT_RANGE:返回数据的范围,以字节记
- CURLOPT_REFERER:前向链接
- CURLOPT_URL:要连接的URL地址,可以在curl_init()中设置
- CURLOPT_USERAGENT:HTTP头中User-Agent的值
- CURLOPT_USERPWD:连接种使用的验证信息
数组选项
CURLOPT_HTTP200ALIASES:200响应码数组,数组中的响应吗被认为是正确的响应
CURLOPT_HTTPHEADER:自定义请求头信息
只能是流句柄的选项:
CURLOPT_FILE:传输要写入的晚间句柄,默认是标准输出
CURLOPT_INFILE:传输要读取的文件句柄
CURLOPT_STDERR:作为标准错误输出的一个替换选项
CURLOPT_WRITEHEADER:传输头信息要写入的文件
回调函数选项
CURLOPT_HEADERFUNCTION:拥有两个参数的回调函数,第一个是参数是会话句柄,第二是HTTP响应头信息的字符串。使用此回调函数,将自行处理响应头信息。响应头信息按行返回。设置返回值为字符串长度。
CURLOPT_READFUNCTION:拥有两个参数的回调函数,第一个是参数是会话句柄,第二是HTTP响应头信息的字符串。使用此函数,将自行处理返回的数据。返回值为数据尺寸。
CURLOPT_WRITEFUNCTION:拥有两个参数的回调函数,第一个是参数是会话句柄,第二是HTTP响应头信息的字符串。使用此回调函数,将自行处理响应头信息。响应头信息是整个字符串。设置返回值为字符串长度
- 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 - 通过设置CURLOPT_SSL_VERIFYPEER返回的SSL证书验证请求的结果
- CURLINFO_CONTENT_LENGTH_DOWNLOAD - 从Content-Length: field中读取的下载内容长度
- CURLINFO_CONTENT_LENGTH_UPLOAD - 上传内容大小的说明
- CURLINFO_CONTENT_TYPE - 下载内容的Content-Type:值,NULL表示服务器没有发送有效的Content-Type: header