Laravel 8.x HTTP 客户端如何为请求设置自定义 User-Agent

Laravel HTTP 客户端支持直接配置自定义请求头，User-Agent 属于标准请求头字段，可通过内置方法快速配置。

你需要设置的自定义User-Agent格式：

Mozilla/5.0+(compatible; EXAMPLE/2.0; http://www.EXAMPLE.com/)

通用兼容写法 #

通过 withHeaders 方法传入请求头数组，兼容所有 Laravel 版本：

$response = Http::timeout($timeout)
    ->withHeaders([
        'User-Agent' => 'Mozilla/5.0+(compatible; EXAMPLE/2.0; http://www.EXAMPLE.com/)',
    ])
    ->get($url);
$code = $response->getStatusCode();

快捷写法 #

Laravel 8.x 内置了 userAgent 链式方法，无需手动构造请求头数组，代码更简洁：

$response = Http::timeout($timeout)
    ->userAgent('Mozilla/5.0+(compatible; EXAMPLE/2.0; http://www.EXAMPLE.com/)')
    ->get($url);
$code = $response->getStatusCode();

注意事项 #

• 两种写法效果完全一致，可根据个人代码习惯选择
• 如果需要复用该UA配置，可将字符串抽取为常量、配置项或环境变量，避免硬编码
• 若后续需要新增其他自定义请求头，直接在 withHeaders 数组中追加键值对即可

内容的提问来源于stack exchange，提问作者Ryan H