在PHP圈子里cURL是个绕不开的老伙计。凡是写过“抓取第三方接口”“模拟请求登录”“爬取页面数据”这类需求的十有八九都用过它。说它是PHP的“瑞士军刀”一点不过分——HTTP请求、HTTPS加密、Cookie会话、文件上传下载、JSON接口对接甚至并发请求它都能扛。这篇文章围绕PHP函数cURL家族展开把常用函数、关键参数、坑和排查思路一次性讲透适合刚接触cURL的新手也适合写了几年PHP、想更系统地补一补cURL细节的老手。有人问为什么不直接用file_get_contents因为cURL是真正的“完整HTTP客户端”能控制请求头、请求体、SSL证书校验、超时时间、代理、Cookie容器还有一套独立的错误码体系。写完下面的内容你会发现困扰你多时的“SSL握手失败”“403被拒”“返回空字符串”等问题几乎都能在cURL家族里找到对应的开关。1. 内容整体设计与思路拆解1.1 为什么把cURL叫作“家族”说它是家族是因为PHP里跟cURL相关的不是孤零零一个函数而是一整套配套API。最典型几个curl_init()创建cURL会话返回一个CurlHandle对象老版本是资源类型。curl_setopt()/curl_setopt_array()设置传输选项这才是cURL的灵魂。curl_exec()执行请求拿到结果。curl_close()关闭会话并释放资源。curl_error()/curl_errno()获取上一次请求的错误信息和错误码。curl_getinfo()获取请求的详细元信息比如HTTP状态码、重定向次数、下载大小、SSL验证结果。curl_multi_init()以及配套的curl_multi_add_handle()、curl_multi_exec()实现并发请求把多个独立请求“打包”在一个多路复用池里跑。这组函数合起来就是一套完整的HTTP客户端工具链所以业内习惯叫“cURL家族”。尤其是CurlHandle对象出现以后cURL的写法比老式资源风格更顺手curl_setopt_array()一次性批量设置选项也让代码清爽不少。1.2 cURL扩展的底层逻辑从libcurl到PHP函数PHP的cURL扩展本质上是一个“封装层”真正的干活的是C语言库libcurl。这意味着你在PHP里设置的所有CURLOPT_*常量最终都会被翻译成libcurl的参数由libcurl去发起真实的网络请求。这个底层逻辑决定了三个很重要的结论第一curl_init()本身并不发起网络请求它只是创建了一个“会话对象”真正干活的是curl_exec()。所以你可以先花大量时间配置选项再一次性执行。第二同一个CurlHandle可以多次执行。比如先GET一个页面改一下CURLOPT_URL再POST一次依然有效只要不curl_close()。第三PHP的cURL行为跟你系统里安装的libcurl版本强相关。curl_version()能拿到当前PHP绑定的是哪个版本的libcurl以及支持的协议列表。如果遇到一些新出的特性例如HTTP/2、某些TLS新选项用不了先查这个版本信息往往答案就在里面。1.3 cURL vs file_get_contents选型分析很多初学者都用过file_get_contents($url)来抓数据它确实能跑通简单的GET请求。但一旦遇到以下场景就得换cURL场景file_get_contentsPHP cURL自定义请求头要靠$http_response_header变通很别扭CURLOPT_HTTPHEADER直接塞数组POST JSON body需要配置stream_context_create()麻烦CURLOPT_POSTCURLOPT_POSTFIELDS一行搞定设置超时到毫秒级固有时钟粒度不够CURLOPT_TIMEOUT_MS支持毫秒忽略SSL证书校验改php.ini全局影响所有代码CURLOPT_SSL_VERIFYPEER定点控制抓取后需要状态码没有专门API靠$http_response_header解析curl_getinfo($ch, CURLINFO_RESPONSE_CODE)并发请求基本做不了curl_multi_*可并行所以我个人判断小项目、单次GET、不关心状态码的时候file_get_contents能用但只要涉及接口对接、模拟登录、文件上传、多个请求同时发请直接上cURL。它看着代码多一点换来的是确定性和控制力。2. 核心细节解析与实操要点2.1 最常用的PHP cURL函数清单把cURL家族整理成表看起来更直观。这里我不打算贴手册只挑日常开发里频率最高的那些函数典型用途注意点curl_init([string $url])创建会话可选初始化URLPHP 8.0后返回CurlHandle对象curl_setopt($ch, $option, $value)设置单个选项常量名别写错比如CURLOPT_RETURNTRANSFER常被少写一个Rcurl_setopt_array($ch, array $options)批量设置选项减少多次调用开销代码更清晰curl_exec($ch)执行请求返回false表示失败开启CURLOPT_RETURNTRANSFER后返回响应体curl_close($ch)关闭会话PHP 8.0后对象会自动释放显式关闭仍推荐curl_error($ch)获取错误信息配合curl_errno()使用错误号为0表示无错误curl_errno($ch)获取错误码错误码不等于HTTP状态码别混curl_getinfo($ch[, $option])获取请求信息常用CURLINFO_RESPONSE_CODE,CURLINFO_TOTAL_TIME,CURLINFO_EFFECTIVE_URLcurl_multi_init()创建并发处理句柄并发请求必须要用它curl_reset($ch)重置会话所有选项循环复用同一句柄时好用这里有个容易被忽视的细节curl_errno()返回的不是HTTP状态码。比如你请求了一个不存在的页面HTTP返回404curl_errno()仍然是0因为TCP层面、TLS层面、HTTP传输都成功了是服务器主动回了个404。要判断“请求是否成功”你既看curl_errno() 0也要用curl_getinfo($ch, CURLINFO_RESPONSE_CODE)确认你期望的状态码。2.2 关键参数详解CURLOPT_*选项怎么选CURLOPT_*常量非常多手册里列了上百个。真正要烂熟于心的我按用途分成几组传输与返回CURLOPT_URL目标URL。一般放在curl_init()里或执行前设置但执行中重定向后会变成最终URL你可以用curl_getinfo($ch, CURLINFO_EFFECTIVE_URL)看到真实地址。CURLOPT_RETURNTRANSFER是否把响应内容作为字符串返回。true就是“返回结果”false则是直接输出到缓冲区。几乎所有封装库第一步都是设它为true不然你很难拿到原始返回体。CURLOPT_HEADER设为true时返回内容里包含响应头。抓包调试、需要解析Set-Cookie时很有用。CURLOPT_NOBODY只发HEAD请求不取响应体适合探测链接是否存在。CURLOPT_FOLLOWLOCATION跟随重定向配合CURLOPT_MAXREDIRS限制最大跳转次数。CURLOPT_AUTOREFERER重定向时自动带上Referer头某些站点会校验来源这个开关能省事。请求体与请求头CURLOPT_POST设为true表示POST请求。CURLOPT_POSTFIELDSPOST数据。传字符串时按application/x-www-form-urlencoded发送传数组时更灵活能构造multipart/form-data适合文件上传。一个常见坑传数组时PHP会为/path/file这种老语法处理文件上传但新版本更推荐用CURLFile对象。CURLOPT_HTTPHEADER数组形式的请求头比如[Content-Type: application/json, Accept: application/json]。CURLOPT_USERAGENT设置User-Agent。很多服务端会校验UA你不想被识别成脚本就设成一个常见浏览器的UA。CURLOPT_REFERER模拟来源页面。CURLOPT_COOKIE直接设置Cookie请求头字符串适合你已经手动拿到了cookie的情况。CURLOPT_COOKIEJAR/CURLOPT_COOKIEFILE把服务器返回的Set-Cookie保存到文件或从文件读取Cookie是模拟登录、保持会话的利器。超时与连接CURLOPT_TIMEOUT整个请求允许的最大秒数。CURLOPT_CONNECTTIMEOUT连接阶段超时。这个很重要否则目标机器不响应时脚本可能挂很久。CURLOPT_TIMEOUT_MS和CURLOPT_CONNECTTIMEOUT_MS毫秒级版本适合对耗时敏感的接口。CURLOPT_DNS_CACHE_TIMEOUTDNS缓存时间。SSL/TLSCURLOPT_SSL_VERIFYPEER是否校验证书。开发环境临时调试可以设false生产环境强烈建议保持true否则等于裸奔。CURLOPT_SSL_VERIFYHOST是否校验主机名与证书CN/SAN匹配。常规设2表示必须校验。CURLOPT_CAINFO指定CA证书路径。公司内网自签名证书、或者系统CA库太旧的场景这个选项能帮你绕过“证书不受信任”的报错同时保留校验能力。CURLOPT_SSLVERSION指定TLS版本比如CURL_SSLVERSION_TLSv1_2或CURL_SSLVERSION_TLSv1_3。其他CURLOPT_USERPWDHTTP Basic认证的用户名密码格式user:password。CURLOPT_HTTPAUTH配合CURLAUTH_BASIC、CURLAUTH_DIGEST等使用。CURLOPT_ENCODING设置Accept-Encoding: gzip并自动解压能省流量。CURLOPT_PROXY走代理请求爬虫抓取、调试联调时会用。2.3 错误获取与调试三件套curl_error、curl_errno、curl_getinfocURL报错最让人头疼的地方在于它经常“什么都不返回”。此时第一反应不应该是怀疑人生而是把这三样掏出来$ch curl_init(https://api.example.com/data); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_TIMEOUT 10, ]); $output curl_exec($ch); if (curl_errno($ch)) { // 这是cURL层面的错误比如超时、TLS握手失败、连接被拒 echo cURL错误号: . curl_errno($ch) . PHP_EOL; echo cURL错误信息: . curl_error($ch) . PHP_EOL; } else { // 这是HTTP层面的状态码即使拿到200也不代表业务成功 $status curl_getinfo($ch, CURLINFO_RESPONSE_CODE); echo HTTP状态码: {$status} . PHP_EOL; // 顺便看下耗时和最终URL排查重定向问题 echo 总耗时: . curl_getinfo($ch, CURLINFO_TOTAL_TIME) . PHP_EOL; echo 最终URL: . curl_getinfo($ch, CURLINFO_EFFECTIVE_URL) . PHP_EOL; } curl_close($ch);这个模板是很推荐的。关键思维是“分层排查”先看传输层是否成功再看HTTP状态码是否符合预期最后解析业务返回体。很多时候cURL返回false而curl_error()却是空的这种情况多半是超时长到像挂起然后被系统中断也可能是目标服务器主动断开了连接。另外说一个我踩过多次的坑curl_getinfo()必须在curl_exec()之后、curl_close()之前调用否则拿不到值。PHP 8.0以后虽然CurlHandle在脚本结束才会释放但你要是提前unset了同样拿不到。2.4 SSL相关选项ssl_verifypeer、CA证书与TLS版本SSL不是cURL独有的麻烦但它在PHP里确实折腾过很多人。从热词里就能看到一堆跟“SSL routines”“certificate problem”相关的搜索。核心要理解三件事第一CURLOPT_SSL_VERIFYPEER到底校验什么。它校验的是对方服务器证书是否由一个受信任的CA签名、证书是否过期、证书链是否完整。系统里必须有一份CA根证书库PHP才能完成校验。Windows环境下如果PHP的curl.cainfo配置没设置或者OpenSSL找不到CA文件就极其容易报出“certificate verify failed”这类错。第二CURLOPT_SSL_VERIFYHOST校验的是主机名。证书里写的是api.example.com你请求的是api.example.com匹配如果你请求的是IP证书按DNS name签发那就会校验失败。这个开关大多数时候保持2即可。第三版本兼容问题。老libcurl不支持TLS 1.3新服务器只支持TLS 1.2以上的时候老版本可能握手失败。排查办法curl_version()[ssl_version]看看OpenSSL版本必要时显式指定CURLOPT_SSLVERSION。生产环境如果真的遇到自签名证书、公司内网证书推荐下载CA证书文件然后设置CURLOPT_CAINFO指向该文件而不是直接关掉校验。这样既避免中间人攻击风险也能正常请求内网服务。3. 实操过程与核心环节实现3.1 基础GET请求与超时控制先给一个可以“抄作业”的GET请求模板。假设要请求一个公开接口返回JSONfunction http_get(string $url, array $headers [], int $timeout 10): array { $ch curl_init($url); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_TIMEOUT $timeout, CURLOPT_CONNECTTIMEOUT 5, CURLOPT_FOLLOWLOCATION true, CURLOPT_MAXREDIRS 3, CURLOPT_USERAGENT Mozilla/5.0 (Windows NT 10.0; Win64; x64) PHP-cURL/.phpversion(), CURLOPT_ENCODING gzip, deflate, ]); if ($headers) { curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); } $body curl_exec($ch); $errno curl_errno($ch); $error curl_error($ch); $status curl_getinfo($ch, CURLINFO_RESPONSE_CODE); curl_close($ch); if ($errno ! 0) { return [ok false, errno $errno, error $error, status 0, body ]; } return [ok true, errno 0, error , status $status, body $body]; } $result http_get(https://api.example.com/articles?page1); print_r($result);几个要点CURLOPT_TIMEOUT设成10秒、连接超时5秒是为了防止接口卡死拖垮整个脚本。如果你在写队列消费脚本超时控制格外重要建议把它做成参数不同任务用不同的超时。CURLOPT_FOLLOWLOCATION开启后如果遇到301/302重定向cURL会自动跳到最终地址。但要注意某些重定向会丢失POST数据遇到这种情况需要检查CURLOPT_POST和CURLOPT_POSTFIELDS的重发逻辑。CURLOPT_ENCODING gzip, deflate会自动带上Accept-Encoding并在获取响应体后解压对抓取一些体积大的页面很有帮助。3.2 POST提交、Cookie与模拟登录POST是接口对接最常见的动作。JSON接口和表单接口的写法略不同。JSON接口$ch curl_init(https://api.example.com/login); $payload json_encode([ username demo, password secret, ], JSON_UNESCAPED_UNICODE); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_POST true, CURLOPT_POSTFIELDS $payload, CURLOPT_HTTPHEADER [ Content-Type: application/json, Accept: application/json, Content-Length: . strlen($payload), ], ]); $body curl_exec($ch); $status curl_getinfo($ch, CURLINFO_RESPONSE_CODE); curl_close($ch);表单接口也就是传统application/x-www-form-urlencoded$ch curl_init(https://example.com/login); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_POST true, CURLOPT_POSTFIELDS http_build_query([ username demo, password secret, remember 1, ]), ]); $body curl_exec($ch); curl_close($ch);注意CURLOPT_POSTFIELDS如果传数组PHP会把它转成multipart/form-data对于普通表单登录服务端可能解析不了所以最好用http_build_query()转成字符串强制使用application/x-www-form-urlencoded。这是一个容易被忽略但非常实用的细节。模拟登录时Cookie管理是关键。假设登录成功后服务器返回Set-Cookie下一次带Cookie访问受保护页面$cookieFile sys_get_temp_dir() . /my_cookie.txt; // 第一次请求登录并把Cookie写入文件 $ch curl_init(https://example.com/login); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_POST true, CURLOPT_POSTFIELDS http_build_query([username demo, password secret]), CURLOPT_COOKIEJAR $cookieFile, ]); curl_exec($ch); curl_close($ch); // 第二次请求读取Cookie文件访问需要登录的页面 $ch curl_init(https://example.com/profile); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_COOKIEFILE $cookieFile, ]); $html curl_exec($ch); curl_close($ch);CURLOPT_COOKIEJAR负责把服务器返回的Cookie存进文件CURLOPT_COOKIEFILE负责发送Cookie。两个搭配起来就能在多个cURL会话之间维持登录态。这也是写“PHP充值卡密类网站”的抓单机器人、或对接第三方后台时的常见套路。3.3 文件上传、下载与断点续传PHP cURL做文件上传关键是CURLFile对象。很多老代码还在用/path/file这在PHP 5.5之后被标记废弃建议直接用CURLFile。上传文件示例$ch curl_init(https://api.example.com/upload); $file new CURLFile(/path/to/local.jpg, image/jpeg, photo.jpg); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_POST true, CURLOPT_POSTFIELDS [ title 我的头像, file $file, ], CURLOPT_HTTPHEADER [Accept: application/json], ]); $body curl_exec($ch); curl_close($ch);这里有个细节CURLOPT_POSTFIELDS传数组时其他字段都会被编码进multipart body文件字段的值必须是CURLFile对象否则不会被正确识别。下载大文件时除了直接拿返回字符串还可以用CURLOPT_FILE把响应体写入文件流。配合CURLOPT_RANGE实现断点续传$fp fopen(/path/to/save.zip, ab); $ch curl_init(https://example.com/bigfile.zip); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_FILE $fp, CURLOPT_RANGE 1048576 . -, // 从第1MB开始下载 CURLOPT_FOLLOWLOCATION true, ]); curl_exec($ch); curl_close($ch); fclose($fp);CURLOPT_FILE会让cURL把响应体直接写入这个句柄而不是返回字符串对处理大文件非常友好不会撑爆内存。CURLOPT_RANGE则让服务器返回指定字节范围服务器支持的话就能续传。注意CURLOPT_RANGE的生效依赖服务器支持Range请求头不是所有下载接口都行。3.4 用curl_multi_*实现并发请求单个请求一个个发在大批量场景里非常浪费时间。比如要调20个查询接口每个耗时300ms串行要6秒用curl_multi_*并发最慢那个决定总时长体验完全不同。curl_multi_init()并发的基本写法function http_multi_get(array $urls): array { $mh curl_multi_init(); $handles []; foreach ($urls as $key $url) { $ch curl_init($url); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER true, CURLOPT_TIMEOUT 10, CURLOPT_CONNECTTIMEOUT 5, ]); curl_multi_add_handle($mh, $ch); $handles[$key] $ch; } $running null; do { $status curl_multi_exec($mh, $running); if ($running) { curl_multi_select($mh, 0.5); // 等待至少一个socket有数据 } } while ($running 0 $status CURLM_OK); $results []; foreach ($handles as $key $ch) { $results[$key] curl_multi_getcontent($ch); curl_multi_remove_handle($mh, $ch); curl_close($ch); } curl_multi_close($mh); return $results; } $urls [ a https://api.example.com/a, b https://api.example.com/b, c https://api.example.com/c, ]; $responses http_multi_get($urls);几个容易踩的点curl_multi_exec()第一次调用就会尝试启动所有请求返回的第二个参数$running表示还有多少请求在执行。循环里必须调用它直到变成0。curl_multi_select()是阻塞等待至少一个连接有响应但PHP手册里提到它可能在没有活动时提前返回所以循环时别省略curl_multi_exec()的轮流检查。每个子请求想单独拿HTTP状态码可以在循环里用curl_getinfo($ch)但要在curl_multi_remove_handle()之前做否则句柄状态可能已经变了。并发量不是越大越好。有些接口方有并发限制建议加个信号量或分批并发比如每批10个请求。3.5 命令行cURL与PHP脚本协同虽然这是PHP cURL主题但命令行curl命令跟PHP里那套函数关系密切。调试时我经常先在终端里用curl -v看完整请求响应确认没问题再抄到PHP里。热词里搜索“curl -v”的人很多因为它就是终端调试的“放大镜”。常见命令组合# 看完整HTTP报文含请求头和响应头 curl -v https://api.example.com/items # 只看响应头 curl -I https://api.example.com/items # 带参数POST curl -X POST https://api.example.com/login -d usernamedemopasswordsecret # 发送JSON curl -X POST https://api.example.com/login -H Content-Type: application/json -d {username:demo,password:secret} # 携带Cookie文件模拟登录后的请求 curl -b cookies.txt https://api.example.com/profile # 设置超时和UA curl -A Mozilla/5.0 --max-time 10 https://api.example.com/items # 二进制文件下载断点续传 curl -C - -o bigfile.zip https://example.com/bigfile.zip命令行里curl -v输出的行是请求头行是响应头SSL connection using TLSv1.3这类信息能快速判断TLS握手出了什么问题。等到PHP那边报错的时候先在命令行里复现一遍常常能定位是请求本身的问题还是PHP配置的问题。我在日常排错中几乎每次都会先跑一次命令行curl把“是不是PHP封装的问题”跟“是不是服务器返回的异常”区分开。3.6 cURL组合技伪协议、序列化与JSONPHP cURL不只是请求外部URL也可以跟PHP内置的php://协议、序列化机制、JSON解析搭配使用组成一些高效的小工具。用php://input接收原始请求体很多接口文档让你传原始JSON用php://input读出来再json_decode是标准做法。配合cURL发送请求时代码要确保Content-Type设置正确否则对方可能解析不了。比如上面JSON接口的例子Content-Type: application/json是关键漏掉这一行服务端可能拿到$_POST为空。JSON序列化和中文编码用json_encode()时我习惯加上JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES避免中文被转成\uXXXX避免URL里的/被转义。这样发给对方接口的数据可读性强日志排查也更方便。PHP序列化数据与接口对接有些老接口不返回JSON而是返回PHP序列化字符串比如a:2:{s:4:code;i:0;s:4:data;...}。处理方式很简单先curl_exec()拿到字符串再unserialize()解析。但要注意如果对方返回的数据末尾有多余空白字符unserialize()会报错可以先trim()一下。另外序列化数据里的对象类型要求先定义对应类否则只会得到__PHP_Incomplete_Class对象。这种场景不多但遇到过一回就会觉得组合技值得掌握。4. 常见问题与排查技巧实录4.1 curl: (35) SSL routines: unexpected eof while reading这是最近搜索量很大的一个错误。完整报错可能是curl: (35) error:0a000126:SSL routines::unexpected eof while reading还有一个相近的error: rpc failed; curl 56 schannel: server closed abruptly (missing close_notify)说人话就是SSL/TLS握手或传输过程中服务器连接在“正常关闭通知close_notify”之前就被掐断了。常见诱因服务器配置了TLS版本限制客户端尝试的TLS版本不被支持。服务器端的防火墙或WAF主动断开了TLS握手。服务商对特定客户端指纹做了拦截。旧版OpenSSL跟新版TLS协议不兼容尤其是Windows下OpenSSL版本过低。排查路径在命令行用curl -v连接目标地址看握手阶段卡在哪。检查本机OpenSSL版本和PHP编译时的SSL库版本是否过旧。php -i | grep -i openssl。尝试显式指定TLS版本curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_2);如果目标是内网灰度环境且你能确认证书本身没问题可以临时设CURLOPT_SSL_VERIFYPEER false验证是不是证书链的问题但生产环境别这么干。4.2 curl: (60) SSL certificate problem: unable to get local issuer certificate这个错误看起来是“本地CA证书缺失”。Linux下经常是因为PHP的curl扩展没配置CA路径Windows下经常是因为没安装CA bundle。解决方案下载cacert.pem在php.ini里配置curl.cainfo指向该文件。或者在代码里指定curl_setopt($ch, CURLOPT_CAINFO, /path/to/cacert.pem);。如果服务端证书是自签名或公司内部CA签发的需要把该CA证书加入信任列表或者用CURLOPT_CAINFO指向公司的根证书。注意不要为了省事直接把CURLOPT_SSL_VERIFYPEER关闭因为这会无声地放弃服务器身份校验存在中间人攻击风险。临时调试可以线上代码里出现这个选项应该被视为警讯。4.3 curl: (22) The requested URL returned error: 403curl: (22)的意思是“服务器返回了非2xx开头的HTTP状态码”。403表示拒绝访问。常见原因和对策服务器做了UA拦截把CURLOPT_USERAGENT设成真实浏览器UA。服务器校验Referer加上CURLOPT_REFERER。服务器对IP频率限制考虑用代理池或加延时。此时命令行里可以加-x指定代理。服务器要求Cookie或登录态先用浏览器或curl -c拿Cookie再在代码中带上。有些CDN/防火墙会校验TLS指纹cURL的TLS指纹太明显可能被识别为爬虫。这种场景比较棘手通常需要模拟浏览器的TLS指纹PHP层面要配合第三方库比如Guzzle cURL参数调优才能解决。排错时不要只盯着错误码先看响应体内容。403页面里往往有验证码、登录跳转、风控提示这些才是解决问题的线索。用curl -v加上-H User-Agent: ...多试几组头部组合。4.4 curl: (23) Failure writing output to destination这个错误一般发生在命令行下载场景PHP里也可能在CURLOPT_FILE写文件时出现。意思是“磁盘写入失败”。最常见的是磁盘空间满了。目标目录没有写权限。fopen()返回的句柄已失效或位置不可写。跨设备移动文件、NFS挂载目录不稳定。处理办法先df -h看磁盘空间touch测试目录可写性检查代码中fopen()是否成功了。如果是在管道中比如curl ... | bash这类用法还得注意管道另一端提前退出导致的写入失败。PHP里用CURLOPT_FILE时建议先判断fopen()结果别直接把false传给cURL。4.5 curl_multi并发时结果全空或串行用curl_multi_*时很多人会写一个简单循环然后发现怎么还是一个个返回的原因是curl_multi_exec()只在第一次调用时真正发起请求后续必须通过curl_multi_select()等待事件然后继续调用curl_multi_exec()让libcurl处理已经完成的数据。如果你漏掉curl_multi_select()或者循环条件写错就可能退化成串行。还有另一个诡异场景并发10个请求有2个总是返回空字符串。排查思路单独对这2个URL发一次普通请求确认不是目标接口本身的问题。检查CURLOPT_TIMEOUT是否过短并发时每个请求的计时是独立的但如果服务器连接池有限等待排队的时间也算在超时里。用curl_error($ch)在curl_multi_getcontent()之前看看有没有报错。4.6 PHP接口返回“数组对象”和跨域JSONP问题很多搜索词指向一个共性困惑PHP接口返回的数据为什么前端拿到的是数组对象为什么有时请求跨域失败先说“数组对象”PHP的json_encode()把数组转成JSON时如果数组键是连续的数字索引会输出[1,2,3]这种数组如果键是字符串会输出{a:1,b:2}这种对象。前端说拿到“数组对象”通常是因为服务端返回了对象结构。想控制输出形态可以在json_encode()前对数据重新索引或用array_values()强制转成列表。再说跨域和JSONP。cURL发送的是服务端到服务端的请求不存在浏览器同源策略问题。跨域问题是浏览器引入的。如果你用cURL请求接口正常但浏览器的AJAX请求报跨域说明需要在PHP响应头里加header(Access-Control-Allow-Origin: *); header(Access-Control-Allow-Methods: GET, POST, OPTIONS); header(Access-Control-Allow-Headers: Content-Type);JSONP则是老式跨域方案接口返回的不是JSON而是callback({...})前端通过script标签加载。PHP侧实现$callback $_GET[callback] ?? callback; $data [code 0, msg ok]; echo $callback . ( . json_encode($data) . );注意$callback要做白名单校验避免被注入恶意脚本。4.7 常见问题速查表现象可能原因处理建议curl_errno()为28请求超时提高CURLOPT_TIMEOUT或检查目标是否可达HTTP 403UA/Referer/IP被限制设置浏览器UA、Referer加延时或代理curl: (60)本地CA证书缺失配置CURLOPT_CAINFO或curl.cainfocurl: (35)unexpected EOFTLS协议不兼容或连接被中断指定CURLOPT_SSLVERSION检查TLS版本返回false但无错误信息超时被中断、目标静默断开增加日志记录连接耗时分层排查并发请求串行curl_multi_*循环写错用前面的并发模板上传文件用file失效PHP 5.5废弃旧语法改用CURLFile中文乱码响应压缩未解压或编码未转换设置CURLOPT_ENCODINGmb_convert_encoding()Cookie带不上没有设置CURLOPT_COOKIEFILE或域名不对检查Cookie文件路径和域名匹配5. 实操心得与建议写到这里该聊一点个人体会了。cURL这套家族函数把我从“靠file_get_contents拼运气”的阶段解放出来是PHP里少有的“愈研究愈觉得有深度”的东西。刚开始我也遇到过request body莫名为空、SSL证书校验失败、并发请求查了半天才发现是循环写错这类问题后来形成一套固定的调试流水线命令行curl先跑拿到状态码和响应头再用PHP封装函数跑明确区分cURL错误和HTTP状态码最后才看业务返回体。这套流水线帮我定位了至少80%的问题。还有一个建议在团队里不要每处都裸写cURL封装一个统一的HTTP客户端层把超时、重试、日志、错误码统一处理掉会省掉很多隐性bug。可以在类里维护一个CurlHandle记录每次请求的curl_getinfo()出问题时可以直接回溯是哪一步、用了什么UA、带了什么Cookie比对着服务器日志猜快得多。最后再分享一个小技巧如果你在调试一个行为诡异的接口给cURL加一个CURLINFO_HEADER_OUT选项然后请求结束后用curl_getinfo($ch, CURLINFO_HEADER_OUT)打开发送的完整请求头。很多“为什么我传了参数对方说没收到”的悬案一看这里的原始请求头就真相大白了。cURL家族值得你在任何PHP项目里花点时间把它用熟它不会辜负你。
