PHP 7.4下载服务器文件时怎么设置User-Agent-php教程-PHP中文网

php 7.4需显式设置user-agent，file_get_contents须用stream_context_create配置'http'数组内小写'user_agent'键，curl则用全大写curlopt_useragent常量并启用returntransfer、followlocation和timeout。

php 7.4下载服务器文件时怎么设置user-agent

PHP 7.4 本身不提供全局默认的 User-Agent，但你在用 file_get_contents() 或 curl 下载远程文件时，必须显式设置它——否则很多网站（尤其是图片站、API、网盘）会直接返回 403 或空响应。

用 `file_get_contents()` 设置 UA 必须配 `stream_context_create()`

file_get_contents() 看似简单，但它底层走的是 PHP 的流封装器（http://），而 UA 是 HTTP 请求头字段，不能靠函数参数传，只能通过上下文配置。常见错误是只改了 user_agent 键却漏掉整个 http 数组层级，或大小写写错。

user_agent 是小写键名，不是 UserAgent 或 USER_AGENT
必须传完整数组：['http' => [...]]，不能只传 ['user_agent' => '...']
仅对 http:// 和 https:// 有效，ftp:// 或自定义协议不支持
无法控制重定向跳转次数、超时精度也弱于 cURL，大文件或不稳定链接容易卡死

示例：

$ctx = stream_context_create([
    'http' => [
        'user_agent' => 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36'
    ]
]);
$content = file_get_contents('https://example.com/image.jpg', false, $ctx);

用 `curl` 设置 UA 更可靠，推荐用于生产环境

curl 是 PHP 7.4 下下载远程资源的事实标准：可控性强、错误反馈明确、支持重试和连接复用。UA 通过 CURLOPT_USERAGENT 设置，注意它和 stream_context_create() 的键名大小写完全不同。

AgentMail Email

专为AI智能体设计的API优先邮件平台，支持创建管理专用邮箱、程序化收发邮件及处理邮件相关任务。

下载

CURLOPT_USERAGENT 是全大写常量，值为字符串；别写成 'useragent' 或 CURLOPT_USER_AGENT（后者不存在）
务必启用 CURLOPT_RETURNTRANSFER，否则 curl_exec() 直接输出内容而不是返回字符串
加 CURLOPT_FOLLOWLOCATION 才能处理 302 跳转，很多 CDN 或短链服务依赖这个
设 CURLOPT_TIMEOUT 防止挂起，PHP 7.4 默认无超时，可能阻塞整个请求

示例（精简版）：

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://example.com/data.json');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)');
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$content = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200 && $content !== false) {
    // 成功
}

UA 字符串选什么？别硬编码，要适配目标站点

不是所有 UA 都通用。有些站点校验 UA 里的操作系统字段（如拒绝 Linux 却放行 Windows），有些则只认 Chrome 或 Safari 的最新版本号。盲目复制浏览器 DevTools 里的 UA 可能因版本过新被识别为自动化工具。

优先参考你用浏览器访问目标 URL 时实际发出的 UA（F12 → Network → 刷新 → 点请求 → Headers → Request Headers → User-Agent）
若目标是图片站或素材库，用带 Windows + Chrome 的 UA 更稳；若目标是企业后台或政务系统，尝试 Mac OS X + Safari 组合
避免使用含 HeadlessChrome、PhantomJS 或明显测试痕迹的 UA 字符串
不要在多个请求间复用同一 UA 并高频调用，部分站点会基于 UA + IP 做频率限制