必须传CURLOPT_URL和CURLOPT_RETURNTRANSFER；前者指定完整URL，后者设为true才能获取响应内容而非直接输出。
curl_setopt 设置远程文件请求时必须传哪些参数
远程访问文件本质是发起 HTTP 请求，curl_setopt 本身不“打开文件”，而是配置 cURL 句柄行为。关键不是“怎么打开”，而是“怎么让请求成功拿到响应体”。漏掉 CURLOPT_RETURNTRANSFER 是最常见错误——默认它直接输出内容，PHP 脚本拿不到字符串。
-
CURLOPT_URL：必须设，填完整 URL（如"https://example.com/data.json"），协议不能省 -
CURLOPT_RETURNTRANSFER：必须设为true，否则curl_exec()返回true/false，不是内容 -
CURLOPT_FOLLOWLOCATION：若目标 URL 会 301/302 跳转（比如 CDN 回源、短链），不设它就停在跳转响应，拿不到最终内容 -
CURLOPT_TIMEOUT：建议显式设（如30），避免 DNS 卡住或远端无响应导致脚本挂起
远程读取二进制文件（图片/PDF）要注意什么
文本类内容（JSON、HTML）用默认编码基本没问题，但图片、压缩包、PDF 等二进制文件，curl_exec() 返回的是原始字节流，不能当字符串处理。一旦你用 json_decode() 或 htmlspecialchars() 去碰它，会出乱码甚至崩溃。
- 不要对二进制响应做任何字符串函数操作（
trim()、mb_convert_encoding()都不行） - 保存前检查
curl_getinfo($ch, CURLINFO_HTTP_CODE)是否为200，避免把 404 页面存成图片 - 写入文件用
file_put_contents($path, $data, LOCK_EX)，$data必须原样传入，不经过任何转换
遇到 SSL 证书错误（cURL error 60）怎么办
本地开发环境或旧系统常报 SSL certificate problem: unable to get local issuer certificate，这不是代码错，是 cURL 找不到 CA 证书路径。强行关验证（CURLOPT_SSL_VERIFYPEER => false）能跑通，但等于放弃 HTTPS 安全校验，线上环境禁止这么干。
- 正确做法：下载最新 CA 包（如 cacert.pem），存到项目目录（如
./certs/cacert.pem） - 然后设置：
CURLOPT_CAINFO => __DIR__ . '/certs/cacert.pem' - Linux 系统级修复可改
/etc/php/*/cli/php.ini加curl.cainfo="/etc/ssl/certs/ca-certificates.crt"
替代方案：file_get_contents 能不能用
能，但限制多。开启 allow_url_fopen = On 才行，而很多生产环境出于安全考虑会关掉它。且它不支持设置超时、重试、自定义 header，连 basic auth 都要靠 stream_context_create() 拼凑，远不如 cURL 灵活。
立即学习“PHP免费学习笔记（深入）”；
if (ini_get('allow_url_fopen')) {
$content = file_get_contents('https://api.example.com/data');
} else {
// 必须 fallback 到 curl
}
真正要稳定读远程文件，别绕开 curl_init() + curl_setopt() 这套流程。参数组合看着多，实际每次只改两三个关键项，其余复用即可。
