在Laravel Http客户端发起API请求时如何分离base URL与接口端点？

Laravel Http客户端底层基于Guzzle封装，完全支持base URL和接口端点拆分使用，实现方式如下：

基础单次调用 #

直接通过baseUrl方法链式声明基础地址，后续请求方法直接传入端点即可：

use Illuminate\Support\Facades\Http;

// base URL为https://stream.twitter.com/，请求端点为statuses/2，最终完整请求地址为https://stream.twitter.com/statuses/2
$response = Http::baseUrl('https://stream.twitter.com/')
    ->post('statuses/2', [
        // 此处填写请求参数
    ]);

多请求复用客户端实例 #

如果同个base URL下有多个接口需要调用，可以先初始化带base URL的客户端实例，后续直接复用即可：

// 初始化带公共base URL的客户端
$client = Http::baseUrl('https://stream.twitter.com/');

// 不同端点复用同一个客户端
$statusResponse = $client->post('statuses/2', []);
$userResponse = $client->get('users/info', ['id' => 123]);
$followResponse = $client->put('users/follow', []);

如果需要添加公共请求配置（比如全局请求头、令牌、超时时间等），可以在初始化客户端时统一配置：

$client = Http::baseUrl('https://stream.twitter.com/')
    ->withToken('你的接口授权令牌')
    ->acceptJson()
    ->timeout(10)
    ->retry(3, 1000);

// 后续所有请求都会自动带上上面的公共配置
$response = $client->post('statuses/2', ['content' => '测试动态']);

进阶：全局配置复用 #

如果base URL是固定的服务地址，可以把配置写到config/services.php配置文件中统一管理：

// config/services.php 中新增配置
'twitter' => [
    'base_url' => env('TWITTER_STREAM_BASE_URL', 'https://stream.twitter.com/'),
    'token' => env('TWITTER_API_TOKEN'),
    'timeout' => 10,
],

调用时直接读取配置即可：

$response = Http::baseUrl(config('services.twitter.base_url'))
    ->withToken(config('services.twitter.token'))
    ->post('statuses/2', []);

还可以通过Http宏进一步封装，简化调用：

// 在app/Providers/AppServiceProvider.php的boot方法中定义宏
public function boot()
{
    Http::macro('twitter', function () {
        return Http::baseUrl(config('services.twitter.base_url'))
            ->withToken(config('services.twitter.token'))
            ->timeout(config('services.twitter.timeout'));
    });
}

封装完成后调用方式如下：

$response = Http::twitter()->post('statuses/2', []);

内容的提问来源于stack exchange，提问作者Akshay Gireesh