採集器、圖片遷移、文件分發等場景常需從遠程 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;
}
<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
";
}
}
?>
CURLOPT_RANGE 實現斷點續傳(需服務端支援 Accept-Ranges: bytes)。fopen($url, 'rb') + fread 寫入本地流,避免記憶體佔用峰值。curl_multi_* 或 Swoole/Workerman 異步協程池。dns_get_record 解析域名後檢查 IP 段。finfo_file 檢測 MIME,拒絕可執行文件(.exe/.php/.sh 等)。CURLOPT_MAXFILESIZE 或 Stream max_file_size 上下文選項。location ~ \.php$ { deny all; }),掛載獨立磁盤/對象存儲。此封裝適合中小文件、低併發場景;大規模分發請使用對象存儲(S3/OSS/COS)預簽名 URL 或 CDN 回源,避免應用服務器成為瓶頸。