PHP 7.4怎么把文件下载到本地？常见问题-php教程-PHP中文网

推荐用 curl 下载，因其支持重定向、超时、http 头定制且内存占用低；小文件可用 file_get_contents + file_put_contents；需认证时用 stream_context_create；注意二进制模式写入、超时设置及权限问题。

php 7.4怎么把文件下载到本地？常见问题

PHP 7.4 把文件从远程服务器下载到本地，核心是“读取远程资源 + 写入本地磁盘”。方法选择取决于文件大小、网络稳定性、是否需要进度控制或认证等。下面列出最常用、最稳妥的几种方式，并说明常见问题和应对建议。

推荐用 cURL 下载（适合大多数场景）

cURL 是 PHP 7.4 默认启用的扩展（需确认 extension=curl 在 php.ini 中未被注释），支持重定向、超时、HTTP 头定制、断点续传基础能力，且内存占用低，不把整个文件加载进内存。

示例代码：

$url = 'https://example.com/report.pdf';
$localPath = '/var/www/downloads/report_' . date('YmdHis') . '.pdf';

$ch = curl_init($url);
$fp = fopen($localPath, 'wb');
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
curl_exec($ch);

if (curl_errno($ch)) {
    error_log('cURL error: ' . curl_error($ch));
}
curl_close($ch);
fclose($fp);

// 检查是否写入成功
if (filesize($localPath) === 0) {
    unlink($localPath);
    throw new Exception('下载失败：文件为空');
}

关键点：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

务必用 fopen(..., 'wb') 以二进制模式打开，避免 Windows 下换行符损坏图片/PDF 等二进制文件
设置 CURLOPT_TIMEOUT 防止大文件卡死
下载后检查 filesize() 或用 curl_getinfo($ch, CURLINFO_HTTP_CODE) 判断 HTTP 状态码是否为 200

小文件可用 file_get_contents + file_put_contents（简单但有风险）

适合几 MB 以内的文本、JSON、小图等。优点是代码极简；缺点是整块加载进内存，大文件易触发 memory_limit 错误，且无错误细节反馈。

$url = 'https://api.example.com/data.json';
$content = file_get_contents($url);
if ($content === false) {
    throw new Exception('file_get_contents failed for: ' . $url);
}
file_put_contents('/tmp/data.json', $content);

注意事项：

确保 allow_url_fopen = On（PHP 7.4 默认开启，但部分主机禁用）
若远程地址返回 404/500，file_get_contents 仍可能返回 false，但不会抛异常，必须手动判断
不适用于需要 Basic Auth、Cookie 或自定义 Header 的请求（除非配合 stream_context_create）

带身份验证或复杂请求头？用 stream_context_create

当目标 URL 需要 Bearer Token、API Key 或 Basic Auth 时，file_get_contents 配合上下文更轻量，比 cURL 更简洁。

$url = 'https://private-api.com/file.zip';
$options = [
    'http' => [
        'method' => 'GET',
        'header' => "Authorization: Bearer abc123\r\n" .
                    "User-Agent: PHP-7.4\r\n"
    ]
];
$context = stream_context_create($options);
$content = file_get_contents($url, false, $context);

if ($content === false) {
    throw new Exception('Auth failed or network error');
}
file_put_contents('/tmp/private.zip', $content);

适用场景：