PHP 8.0怎么把文件下载到本地？详细步骤-php教程-PHP中文网

php 8.0 下载远程文件到本地有三种安全方法：1. 小文件用 file_get_contents() + file_put_contents()；2. 大文件用 fopen() 流式读写防内存溢出；3. 需认证或重定向时用 curl，并须校验 url 白名单、协议、路径和后缀。

php 8.0怎么把文件下载到本地？详细步骤

PHP 8.0 把文件下载到本地，核心是「把远程文件内容获取并写入本地磁盘」，不是让浏览器下载——这点常被混淆。下面分场景说明实用、安全、可落地的方法。

直接保存远程 URL 文件到本地（推荐小文件）

适合 PDF、TXT、小图等几 MB 以内的文件。用 file_get_contents() + file_put_contents() 最简洁：

确保 allow_url_fopen = On 在 php.ini 中启用（默认开启）
代码示例：

$url = 'https://example.com/report.pdf';
$localPath = '/var/www/html/downloads/report_202609.pdf';

$content = file_get_contents($url);
if ($content !== false) {
    file_put_contents($localPath, $content);
    echo "文件已保存至：" . $localPath;
} else {
    echo "下载失败：URL 不可达或权限拒绝";
}

⚠️ 注意：该方式会把整个文件读进内存，不适用于 >10MB 的大文件，否则可能触发内存溢出（Allowed memory size exhausted）。

流式下载大文件（避免内存爆满）

适合 ZIP、视频、数据库备份等几十 MB 到 GB 级文件。用 fopen() 流读取 + fwrite() 分块写入：

PHP

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

下载

无需加载全部内容进内存，边读边写，稳定可控
示例（含基础错误处理）：

$url = 'https://example.com/large-backup.zip';
$localPath = '/tmp/backup_'.date('Ymd_His').'.zip';

$in = fopen($url, 'rb');
$out = fopen($localPath, 'wb');

if ($in && $out) {
    while (!feof($in)) {
        fwrite($out, fread($in, 8192));
    }
    fclose($in);
    fclose($out);
    echo "大文件已流式保存完成";
} else {
    echo "打开远程或本地文件失败，请检查路径、权限和 URL 可访问性";
}

✅ 提示：若服务器禁用了 allow_url_fopen，需改用 cURL 方式（见下一条）。

用 cURL 下载（兼容性强，支持认证与重定向）

当远程资源需要 Basic Auth、Bearer Token、跳转（302）、自定义 User-Agent 或超时控制时，cURL 是更可靠的选择：

支持断线重试、进度回调、SSL 验证开关
示例（含常见选项）：

$url = 'https://api.example.com/files/data.xlsx';
$localPath = '/home/user/downloads/data.xlsx';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, false); // 关键：不返回内容，直接写入文件
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 生产环境建议设为 true 并配 CA
curl_setopt($ch, CURLOPT_TIMEOUT, 300); // 5分钟超时
curl_setopt($ch, CURLOPT_FILE, fopen($localPath, 'w'));

$result = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

curl_close($ch);

if ($result !== false && $httpCode === 200 && file_exists($localPath)) {
    echo "cURL 下载成功，大小：" . filesize($localPath) . " 字节";
} else {
    echo "cURL 下载失败，HTTP 状态码：$httpCode";
}

安全提醒（务必执行）

无论用哪种方式，只要涉及用户可控输入（比如从 GET 参数拼 URL），必须做以下校验，否则存在严重风险：

URL 白名单校验：只允许来自可信域名（如 in_array(parse_url($url, PHP_URL_HOST), ['files.example.com', 'cdn.myapp.com'])）
禁止协议绕过：拒绝 php://filter、data://、file:// 等非 HTTP(S) 协议
路径规范化：本地保存路径用 realpath() + dirname() 校验，防止写入系统敏感目录
后缀强制约束：根据业务限定可下载类型（如仅 ['pdf', 'xlsx', 'csv']），拒绝 .php、.log 等危险扩展名