PHP 5.6+默认校验SSL证书,自签名或过期证书会报错;file_get_contents()发POST需匹配Content-Type与请求体格式;PHP 7.0+废弃部分cURL常量;响应编码需手动检测转换。
PHP 5.6+ 默认启用 SSL 证书验证,老接口若用自签名证书或过期证书,curl_init() 会直接报错中断。这不是代码写错了,是安全策略升级带来的兼容性断裂。
实操建议:
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false) 关闭验证(仅限测试环境)curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem') 指向最新证书文件CURLOPT_SSL_VERIFYHOST => 2(默认值),别设成 0 或 1,后者已废弃且不安全用 file_get_contents() 发 POST 看似简洁,但 http_build_query() 和原始 JSON 体不能混用——前者生成 application/x-www-form-urlencoded,后者需手动设 Content-Type: application/json 且传 raw 字符串。
常见错误现象:接口返回 “invalid json” 或 “missing parameter”,其实是请求体格式和 header 不匹配。
实操建议:
http_build_query(['a'=>1,'b'=>2]),header 中必须含 Content-Type: application/x-www-form-urlencoded
json_encode(['a'=>1,'b'=>2]),header 中设 Content-Type: application/json
Content-Length,PHP 一般自动计算,但某些代理或 Nginx 配置下会丢,可显式加上PHP 7.0 废弃了 CURLOPT_SSLVERSION 的部分常量值,比如 CURL_SSLVERSION_TLSv1_0 在 PHP 7.3+ 才支持;而老项目若硬编码 CURL_SSLVERSION_TLSv1,在 PHP 8.0+ 会静默降级为 TLSv1.2,导致对接某些只认 TLSv1.0 的银行/政务接口失败。
实操建议:
CURL_SSLVERSION_TLSv1_1,不是 TLSv1_1)defined('CURL_SSLVERSION_TLSv1_2') ?: define('CURL_SSLVERSION_TLSv1_2', 6) 做兜底curl_version() 输出实际生效的 SSL 库(OpenSSL / GnuTLS),不同库对 TLS 版本的支持粒度不同不是所有接口都返回 UTF-8。有些老系统用 GBK、ISO-8859-1,而 PHP cURL 默认不处理响应编码转换,file_get_contents() 返回的字符串直接 echo 可能显示,json_decode() 会失败并返回 null。
实操建议:
curl_getinfo($ch, CURLINFO_CONTENT_TYPE),看是否有 charset=gbk 这类提示mb_detect_encoding($response, ['UTF-8','GBK','BIG5'], true) 粗略判断(注意第三个参数必须为 true)$utf8 = mb_convert_encoding($response, 'UTF-8', 'GBK'),之后再 json_decode() 或正则提取版本兼容不是加个 if 就完事——关键在 SSL 行为、常量定义、编码推断这三处,稍不留意,请求就发出去了,但对方根本没收到有效数据。