0

0

php curl选项列表(超详细)_php技巧

php中文网

php中文网

发布时间:2016-05-17 08:57:23

|

1452人浏览过

|

来源于php中文网

原创

第一类:
对于下面的这些option的可选参数,value应该被设置一个bool类型的值:
选项
可选value值
备注

curlopt_autoreferer
当根据location:重定向时,自动设置header中的referer:信息。
curlopt_binarytransfer
在启用curlopt_returntransfer的时候,返回原生的(raw)输出。
curlopt_cookiesession
启用时curl会仅仅传递一个session cookie,忽略其他的cookie,默认状况下curl会将所有的cookie返回给服务端。session cookie是指那些用来判断服务器端的session是否有效而存在的cookie。
curlopt_crlf
启用时将unix的换行符转换成回车换行符。
curlopt_dns_use_global_cache
启用时会启用一个全局的dns缓存,此项为线程安全的,并且默认启用。
curlopt_failonerror
显示http状态码,默认行为是忽略编号小于等于400的http信息。
curlopt_filetime
启用时会尝试修改远程文档中的信息。结果信息会通过 curl_getinfo()函数的curlinfo_filetime选项返回。curl_getinfo().
curlopt_followlocation
启用时会将服务器服务器返回的"location: "放在header中递归的返回给服务器,使用curlopt_maxredirs可以限定递归返回的数量。
curlopt_forbid_reuse
在完成交互以后强迫断开连接,不能重用。
curlopt_fresh_connect
强制获取一个新的连接,替代缓存中的连接。
curlopt_ftp_use_eprt
启用时当ftp下载时,使用eprt (或 lprt)命令。设置为false时禁用eprt和lprt,使用port命令 only.
curlopt_ftp_use_epsv
启用时,在ftp传输过程中回复到pasv模式前首先尝试epsv命令。设置为false时禁用epsv命令。
curlopt_ftpappend
启用时追加写入文件而不是覆盖它。
curlopt_ftpascii
curlopt_transfertext的别名。
curlopt_ftplistonly
启用时只列出ftp目录的名字。
curlopt_header
启用时会将头文件的信息作为数据流输出。
curlinfo_header_out
启用时追踪句柄的请求字符串。
php 5.1.3 开始可用。curlinfo_前缀是故意的(intentional)。

curlopt_httpget
启用时会设置http的method为get,因为get是默认是,所以只在被修改的情况下使用。
curlopt_httpproxytunnel
启用时会通过http代理来传输。
curlopt_mute
启用时将curl函数中所有修改过的参数恢复默认值。
curlopt_netrc
在连接建立以后,访问~/.netrc文件获取用户名和密码信息连接远程站点。
curlopt_nobody
启用时将不对html中的body部分进行输出。
curlopt_noprogress
启用时关闭curl传输的进度条,此项的默认设置为启用。
note:
php自动地设置这个选项为true,这个选项仅仅应当在以调试为目的时被改变。

curlopt_nosignal
启用时忽略所有的curl传递给php进行的信号。在sapi多线程传输时此项被默认启用。
curl 7.10时被加入。

curlopt_post
启用时会发送一个常规的post请求,类型为:application/x-www-form-urlencoded,就像表单提交的一样。
curlopt_put
启用时允许http发送文件,必须同时设置curlopt_infile和curlopt_infilesize。
curlopt_returntransfer
将 curl_exec()获取的信息以文件流的形式返回,而不是直接输出。
curlopt_ssl_verifypeer
禁用后curl将终止从服务端进行验证。使用curlopt_cainfo选项设置证书使用curlopt_capath选项设置证书目录 如果curlopt_ssl_verifypeer(默认值为2)被启用,curlopt_ssl_verifyhost需要被设置成true否则设置为false。
自curl 7.10开始默认为true。从curl 7.10开始默认绑定安装。

curlopt_transfertext
启用后对ftp传输使用ascii模式。对于ldap,它检索纯文本信息而非html。在windows系统上,系统不会把stdout设置成binary模式。
curlopt_unrestricted_auth
在使用curlopt_followlocation产生的header中的多个locations中持续追加用户名和密码信息,即使域名已发生改变。
curlopt_upload
启用后允许文件上传。
curlopt_verbose
启用时会汇报所有的信息,存放在stderr或指定的curlopt_stderr中。

第二类:
对于下面的这些option的可选参数,value应该被设置一个integer类型的值:
选项
可选value值
备注

curlopt_buffersize
每次获取的数据中读入缓存的大小,但是不保证这个值每次都会被填满。
在curl 7.10中被加入。

curlopt_closepolicy
不是curlclosepolicy_least_recently_used就是curlclosepolicy_oldest,还存在另外三个curlclosepolicy_,但是curl暂时还不支持。
curlopt_connecttimeout
在发起连接前等待的时间,如果设置为0,则无限等待。
curlopt_connecttimeout_ms
尝试连接等待的时间,以毫秒为单位。如果设置为0,则无限等待。
在curl 7.16.2中被加入。从php 5.2.3开始可用。

curlopt_dns_cache_timeout
设置在内存中保存dns信息的时间,默认为120秒。
curlopt_ftpsslauth
ftp验证方式:curlftpauth_ssl (首先尝试ssl),curlftpauth_tls (首先尝试tls)或curlftpauth_default (让curl自动决定)。
在curl 7.12.2中被加入。

curlopt_http_version
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
设定上传文件的大小限制,字节(byte)为单位。
curlopt_low_speed_limit
当传输速度小于curlopt_low_speed_limit时(bytes/sec),php会根据curlopt_low_speed_time来判断是否因太慢而取消传输。
curlopt_low_speed_time
当传输速度小于curlopt_low_speed_limit时(bytes/sec),php会根据curlopt_low_speed_time来判断是否因太慢而取消传输。
curlopt_maxconnects
允许的最大连接数量,超过是会通过curlopt_closepolicy决定应该停止哪些连接。
curlopt_maxredirs
指定最多的http重定向的数量,这个选项是和curlopt_followlocation一起使用的。
curlopt_port
用来指定连接端口。(可选项)
curlopt_protocols
curlproto_*的位域指。如果被启用,位域值会限定libcurl在传输过程中有哪些可使用的协议。这将允许你在编译libcurl时支持众多协议,但是限制只是用它们中被允许使用的一个子集。默认libcurl将会使用全部它支持的协议。参见curlopt_redir_protocols.
可用的协议选项为:curlproto_http、curlproto_https、curlproto_ftp、curlproto_ftps、curlproto_scp、curlproto_sftp、curlproto_telnet、curlproto_ldap、curlproto_ldaps、curlproto_dict、curlproto_file、curlproto_tftp、curlproto_all
在curl 7.19.4中被加入。

curlopt_proxyauth
http代理连接的验证方式。使用在curlopt_httpauth中的位域标志来设置相应选项。对于代理验证只有curlauth_basic和curlauth_ntlm当前被支持。
在curl 7.10.7中被加入。

curlopt_proxyport
代理服务器的端口。端口也可以在curlopt_proxy中进行设置。
curlopt_proxytype
不是curlproxy_http (默认值) 就是curlproxy_socks5。
在curl 7.10中被加入。

curlopt_redir_protocols
curlproto_*中的位域值。如果被启用,位域值将会限制传输线程在curlopt_followlocation开启时跟随某个重定向时可使用的协议。这将使你对重定向时限制传输线程使用被允许的协议子集默认libcurl将会允许除file和scp之外的全部协议。这个和7.19.4预发布版本种无条件地跟随所有支持的协议有一些不同。关于协议常量,请参照curlopt_protocols。
在curl 7.19.4中被加入。

curlopt_resume_from
在恢复传输时传递一个字节偏移量(用来断点续传)。
curlopt_ssl_verifyhost
1 检查服务器ssl证书中是否存在一个公用名(common name)。译者注:公用名(common name)一般来讲就是填写你将要申请ssl证书的域名 (domain)或子域名(sub domain)。2 检查公用名是否存在,并且是否与提供的主机名匹配。
curlopt_sslversion
使用的ssl版本(2 或 3)。默认情况下php会自己检测这个值,尽管有些情况下需要手动地进行设置。
curlopt_timecondition
如果在curlopt_timevalue指定的某个时间以后被编辑过,则使用curl_timecond_ifmodsince返回页面,如果没有被修改过,并且curlopt_header为true,则返回一个"304 not modified"的header,        curlopt_header为false,则使用curl_timecond_ifunmodsince,默认值为curl_timecond_ifunmodsince。
curlopt_timeout
设置curl允许执行的最长秒数。
curlopt_timeout_ms
设置curl允许执行的最长毫秒数。
在curl 7.16.2中被加入。从php 5.2.3起可使用。

curlopt_timevalue
设置一个curlopt_timecondition使用的时间戳,在默认状态下使用的是curl_timecond_ifmodsince。
 
第三类:
对于下面的这些option的可选参数,value应该被设置一个string类型的值:
选项
可选value值
备注

curlopt_cainfo
一个保存着1个或多个用来让服务端验证的证书的文件名。这个参数仅仅在和curlopt_ssl_verifypeer一起使用时才有意义。 .
curlopt_capath
一个保存着多个ca证书的目录。这个选项是和curlopt_ssl_verifypeer一起使用的。
curlopt_cookie
设定http请求中"cookie: "部分的内容。多个cookie用分号分隔,分号后带一个空格(例如, "fruit=apple; colour=red")。
curlopt_cookiefile
包含cookie数据的文件名,cookie文件的格式可以是netscape格式,或者只是纯http头部信息存入文件。
curlopt_cookiejar
连接结束后保存cookie信息的文件。
curlopt_customrequest
使用一个自定义的请求信息来代替"get"或"head"作为http请求。这对于执行"delete" 或者其他更隐蔽的http请求。有效值如"get","post","connect"等等。也就是说,不要在这里输入整个http请求。例如输入"get /index.html http/1.0\r\n\r\n"是不正确的。
note:
在确定服务器支持这个自定义请求的方法前不要使用。

 
curlopt_egdsocket
类似curlopt_random_file,除了一个entropy gathering daemon套接字。
curlopt_encoding
http请求头中"accept-encoding: "的值。支持的编码有"identity","deflate"和"gzip"。如果为空字符串"",请求头会发送所有支持的编码类型。
在curl 7.10中被加入。

curlopt_ftpport
这个值将被用来获取供ftp"post"指令所需要的ip地址。"post"指令告诉远程服务器连接到我们指定的ip地址。这个字符串可以是纯文本的ip地址、主机名、一个网络接口名(unix下)或者只是一个'-'来使用默认的ip地址。
curlopt_interface
网络发送接口名,可以是一个接口名、ip地址或者是一个主机名。
curlopt_krb4level
krb4 (kerberos 4) 安全级别。下面的任何值都是有效的(从低到高的顺序):"clear"、"safe"、"confidential"、"private".。如果字符串和这些都不匹配,将使用"private"。这个选项设置为null时将禁用krb4 安全认证。目前krb4 安全认证只能用于ftp传输。
curlopt_postfields
全部数据使用http协议中的"post"操作来发送。要发送文件,在文件名前面加上@前缀并使用完整路径。这个参数可以通过urlencoded后的字符串类似'para1=val1¶2=val2&...'或使用一个以字段名为键值,字段数据为值的数组。如果value是一个数组,content-type头将会被设置成multipart/form-data。
curlopt_proxy
http代理通道。
curlopt_proxyuserpwd
一个用来连接到代理的"[username]:[password]"格式的字符串。
curlopt_random_file
一个被用来生成ssl随机数种子的文件名。
curlopt_range
以"x-y"的形式,其中x和y都是可选项获取数据的范围,以字节计。http传输线程也支持几个这样的重复项中间用逗号分隔如"x-y,n-m"。
curlopt_referer
在http请求头中"referer: "的内容。
curlopt_ssl_cipher_list
一个ssl的加密算法列表。例如rc4-sha和tlsv1都是可用的加密列表。
curlopt_sslcert
一个包含pem格式证书的文件名。
curlopt_sslcertpasswd
使用curlopt_sslcert证书需要的密码。
curlopt_sslcerttype
证书的类型。支持的格式有"pem" (默认值), "der"和"eng"。
在curl 7.9.3中被加入。

curlopt_sslengine
用来在curlopt_sslkey中指定的ssl私钥的加密引擎变量。
curlopt_sslengine_default
用来做非对称加密操作的变量。
curlopt_sslkey
包含ssl私钥的文件名。
curlopt_sslkeypasswd
在curlopt_sslkey中指定了的ssl私钥的密码。
note:
由于这个选项包含了敏感的密码信息,记得保证这个php脚本的安全。

curlopt_sslkeytype
curlopt_sslkey中规定的私钥的加密类型,支持的密钥类型为"pem"(默认值)、"der"和"eng"。
curlopt_url
需要获取的url地址,也可以在 curl_init()函数中设置。
curlopt_useragent
在http请求中包含一个"user-agent: "头的字符串。
curlopt_userpwd
传递一个连接中需要的用户名和密码,格式为:"[username]:[password]"。

 
第四类
对于下面的这些option的可选参数,value应该被设置一个数组:
选项
可选value值
备注
 
curlopt_http200aliases
200响应码数组,数组中的响应吗被认为是正确的响应,否则被认为是错误的。
在curl 7.10.3中被加入。

curlopt_httpheader
一个用来设置http头字段的数组。使用如下的形式的数组进行设置: array('content-type: text/plain', 'content-length: 100')
curlopt_postquote
在ftp请求执行完成后,在服务器上执行的一组ftp命令。
curlopt_quote
一组先于ftp请求的在服务器上执行的ftp命令。

对于下面的这些option的可选参数,value应该被设置一个流资源 (例如使用 fopen()):
选项
可选value值

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

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

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

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

对于下面的这些option的可选参数,value应该被设置为一个回调函数名:
选项
可选value值

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

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

CURLOPT_PROGRESSFUNCTION
设置一个回调函数,有三个参数,第一个是cURL的资源句柄,第二个是一个文件描述符资源,第三个是长度。返回包含的数据。
 
CURLOPT_READFUNCTION
拥有两个参数的回调函数,第一个是参数是会话句柄,第二是HTTP响应头信息的字符串。使用此函数,将自行处理返回的数据。返回值为数据大小,以字节计。返回0代表EOF信号。

CURLOPT_WRITEFUNCTION
拥有两个参数的回调函数,第一个是参数是会话句柄,第二是HTTP响应头信息的字符串。使用此回调函数,将自行处理响应头信息。响应头信息是整个字符串。设置返回值为精确的已写入字符串长度。发生错误时传输线程终止。

橙篇
橙篇

百度文库发布的一款综合性AI创作工具

下载

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

705

2026.02.13

微博网页版主页入口与登录指南_官方网页端快速访问方法
微博网页版主页入口与登录指南_官方网页端快速访问方法

本专题系统整理微博网页版官方入口及网页端登录方式,涵盖首页直达地址、账号登录流程与常见访问问题说明,帮助用户快速找到微博官网主页,实现便捷、安全的网页端登录与内容浏览体验。

233

2026.02.13

Flutter跨平台开发与状态管理实战
Flutter跨平台开发与状态管理实战

本专题围绕Flutter框架展开,系统讲解跨平台UI构建原理与状态管理方案。内容涵盖Widget生命周期、路由管理、Provider与Bloc状态管理模式、网络请求封装及性能优化技巧。通过实战项目演示,帮助开发者构建流畅、可维护的跨平台移动应用。

117

2026.02.13

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

22

2026.02.13

Redis高可用架构与分布式缓存实战
Redis高可用架构与分布式缓存实战

本专题围绕 Redis 在高并发系统中的应用展开,系统讲解主从复制、哨兵机制、Cluster 集群模式及数据分片原理。内容涵盖缓存穿透与雪崩解决方案、分布式锁实现、热点数据优化及持久化策略。通过真实业务场景演示,帮助开发者构建高可用、可扩展的分布式缓存系统。

61

2026.02.13

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

30

2026.02.12

雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法
雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法

本专题系统整理雨课堂网页版官方入口及在线登录方式,涵盖账号登录流程、官方直连入口及平台访问方法说明,帮助师生用户快速进入雨课堂在线教学平台,实现便捷、高效的课程学习与教学管理体验。

15

2026.02.12

豆包AI网页版入口与智能创作指南_官方在线写作与图片生成使用方法
豆包AI网页版入口与智能创作指南_官方在线写作与图片生成使用方法

本专题汇总豆包AI官方网页版入口及在线使用方式,涵盖智能写作工具、图片生成体验入口和官网登录方法,帮助用户快速直达豆包AI平台,高效完成文本创作与AI生图任务,实现便捷智能创作体验。

669

2026.02.12

PostgreSQL性能优化与索引调优实战
PostgreSQL性能优化与索引调优实战

本专题面向后端开发与数据库工程师,深入讲解 PostgreSQL 查询优化原理与索引机制。内容包括执行计划分析、常见索引类型对比、慢查询优化策略、事务隔离级别以及高并发场景下的性能调优技巧。通过实战案例解析,帮助开发者提升数据库响应速度与系统稳定性。

58

2026.02.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12.1万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号