PHP curl 报错怎么解决

在做网站开发或者小程序对接的时候，你是不是经常碰到这种情况：明明写好了调用第三方接口的代码，运行后却弹出一串看不懂的报错，要么是“curl error 7”，要么是“SSL certificate problem”，瞬间头大。其实这些报错大多和PHP里的curl工具有关，今天就用大家能听懂的话，把常见的curl报错解决方法讲明白，都是实际开发中踩过的坑，看完就能直接用。

先搞懂：PHP curl 到底是用来干啥的？

很多新手可能还没搞清楚这个工具的作用，举个生活化的例子：你要给远方的朋友送快递，curl就相当于快递员，帮你把要发的“数据包裹”送到别的服务器（比如天气接口、支付接口），再把对方回的“消息”带回来。如果快递员在路上出问题，就会弹出对应的curl报错，搞懂这个逻辑，就不会对着报错抓瞎了。

最常见的3种报错，附快速解决方法

报错：“cURL error 7: Failed to connect to xxx.com”

举个生活化的例子：你要寄快递到一个小区，但这个小区的地址写错了，或者根本不存在，快递员就找不到收件人，直接报错。对应到代码里，就是你写的接口域名写错了，或者服务器本身的网络出了问题。

解决方法分两步：

第一，先检查接口域名有没有拼写错误，比如把“api.weather.com”写成“api.weater.com”，改过来就好；

第二，要是域名没错，可能是你的服务器被防火墙挡住了，或者没连上网，找服务器运维同事检查下端口能不能通，比如用电脑cmd输“ping xxx.com”，能通就说明网络正常，不能通就需要调整安全规则。

报错：“SSL certificate problem: unable to get local issuer certificate”

这个报错是新手碰到最多的，相当于你寄快递时，对方小区要求必须有官方认证的快递员才能进，但你带的认证过期了或者根本没办。对应到代码里，就是PHP用来验证接口安全的SSL证书文件缺失或者配置错了。

解决方法很简单，不用自己弄复杂的证书，直接三步搞定：

第一步，下载官方的证书文件，随便搜“cacert.pem”，找到官网的最新版本下载；

第二步，把下载好的文件放到你的PHP安装目录里，比如“C:\php\extras\ssl\cacert.pem”或者服务器上的“/usr/local/php/etc/ssl/cacert.pem”；

第三步，在curl请求的代码里加上一行：curl_setopt($ch, CURLOPT_CAINFO, "证书文件的完整路径");，替换成你放证书的位置就行，重启服务后就不会报错了。

报错：“cURL error 28: Operation timed out after xxx milliseconds”

这个相当于你寄的快递超重太多，快递员送了半天没送到，超时了。对应到代码里，就是请求第三方接口时，对方服务器响应太慢，超过了PHP设置的超时时间，就会弹出这个报错。

解决方法分两种情况：

如果是第三方接口本身就慢（比如天气接口有时候高峰时段响应慢），可以适当把超时时间调长，代码里加一行：curl_setopt($ch, CURLOPT_TIMEOUT, 10);，把默认的5秒改成10秒，就不容易超时；

如果是接口偶尔超时，还可以加个重试机制：第一次请求超时后，再重试1次，最多重试2次，既不影响效率，又能减少报错。

最后说个通用小技巧

碰到curl报错别慌，先看报错最后带的数字，比如error7、error28，再去搜这个数字对应的意思，比搜整个报错内容快得多。另外，要是本地测试没问题，放到线上就报错，大概率是线上服务器的网络、证书配置和本地不一样，重点查这两个地方，基本能解决80%的问题。

其实PHP curl报错本质就是快递员的问题，要么地址错了、要么认证不够、要么路上太慢，对应到代码里都是很具体的小问题，照着上面的方法试，基本都能快速解决，不用再对着一堆英文报错头大啦。