萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 遠程下載文件到本地:cURL 優先、Stream 兜底、目錄自建、超時控制完整封裝

採集器、圖片遷移、文件分發等場景常需從遠程 URL 下載文件保存至服務器。本文提供一個健壯的 httpcopy() 函數:優先使用 cURL(支援 HTTPS、重定向、攔截器),回退至 Stream Context;自動創建目標目錄;URL 空格編碼;超時控制;返回保存路徑或 false。

核心函數

function httpcopy(string $url, string $file = '', int $timeout = 60): string|false {
    $file = $file ?: basename($url);
    $dir  = dirname($file);
    if ($dir !== '.' && !is_dir($dir)) {
        @mkdir($dir, 0755, true);
    }
    $url = str_replace(' ', '%20', $url);

    // 1. cURL 路徑(推薦)
    if (function_exists('curl_init')) {
        $ch = curl_init($url);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => $timeout,
            CURLOPT_FOLLOWLOCATION => true,
            CURLOPT_MAXREDIRS      => 5,
            CURLOPT_SSL_VERIFYPEER => true,  // 生產必開
            CURLOPT_SSL_VERIFYHOST => 2,
            CURLOPT_USERAGENT      => 'Mozilla/5.0 (compatible; PHP/httpcopy)',
        ]);
        $content = curl_exec($ch);
        $errno   = curl_errno($ch);
        curl_close($ch);

        if ($errno === 0 && $content !== false && @file_put_contents($file, $content) !== false) {
            return $file;
        }
        return false;
    }

    // 2. Stream Context 兜底
    $ctx = stream_context_create([
        'http' => [
            'method'  => 'GET',
            'timeout' => $timeout,
            'header'  => 'User-Agent: PHP/httpcopy',
        ],
        'ssl' => [
            'verify_peer'      => true,
            'verify_peer_name' => true,
        ],
    ]);
    return @copy($url, $file, $ctx) ? $file : false;
}

表單上傳 URL 批量下載示例

<form method="post">
  <textarea name="urls" rows="10" cols="80" placeholder="每行一個 URL"></textarea>
  <button>開始下載</button>
</form>

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST' && !empty($_POST['urls'])) {
    set_time_limit(3600);
    $dest = sys_get_temp_dir() . '/downloads/';
    foreach (preg_split('/\s+/', trim($_POST['urls'])) as $url) {
        $saved = httpcopy($url, $dest . basename($url), 120);
        echo $saved ? "✅ $saved
" : "❌ $url
"; } } ?>

大文件下載優化(分片/斷點續傳)

  • cURL CURLOPT_RANGE 實現斷點續傳(需服務端支援 Accept-Ranges: bytes)。
  • 大文件改用 fopen($url, 'rb') + fread 寫入本地流,避免記憶體佔用峰值。
  • 並發下載:curl_multi_* 或 Swoole/Workerman 異步協程池。

安全與合規清單

  1. SSRF 防護:禁止訪問內網 IP(10.x、172.16-31.x、192.168.x、127.x、169.254.x)、元數據服務(169.254.169.254)、localhost。使用 dns_get_record 解析域名後檢查 IP 段。
  2. 文件類型驗證:下載後用 finfo_file 檢測 MIME,拒絕可執行文件(.exe/.php/.sh 等)。
  3. 大小限制:設置 CURLOPT_MAXFILESIZE 或 Stream max_file_size 上下文選項。
  4. 存儲隔離:下載目錄禁用腳本執行權限(Nginx location ~ \.php$ { deny all; }),掛載獨立磁盤/對象存儲。
  5. 審計日誌:記錄操作者、URL、保存路徑、文件哈希、時間戳。

此封裝適合中小文件、低併發場景;大規模分發請使用對象存儲(S3/OSS/COS)預簽名 URL 或 CDN 回源,避免應用服務器成為瓶頸。

copyright © 萬盛學電腦網 all rights reserved