webman-tech/laravel-http-client

Laravel illuminate/http 中的 HttpClient for webman

介绍

站在巨人（laravel）的肩膀上使文件存储使用更加可靠和便捷

所有方法和配置与 laravel 几乎一模一样，因此使用方式完全参考 Laravel文档 即可

安装

composer require webman-tech/laravel-http-client

使用

所有 API 同 laravel，以下仅对有些特殊的操作做说明

Facade 入口

使用 WebmanTech\LaravelHttpClient\Facades\Http 代替 Illuminate\Support\Facades\Http

请求日志

配置文件 config/plugin/webman-tech/laravel-http-client/app.php 中的 log 栏目可以配置日志相关

默认未启用

默认的 guzzle options 配置

配置文件 config/plugin/webman-tech/laravel-http-client/app.php 中的 guzzle 栏目可以配置 guzzle 的默认配置

会在每次发送请求是使用该默认值

快速定义与简化 api 调用

如果接口请求比较多，建议通过 macros 来预定义一些接口的请求信息（比如 baseUrl、Headers 等）

配置文件 config/plugin/webman-tech/laravel-http-client/app.php 中的 macros 栏目中

举例：

config

return [ // 其他配置省略 'macros' => [ 'httpbin' => function() { return Http::baseUrl('https://httpbin.org') ->asJson(); } ], ];

使用

$response = \WebmanTech\LaravelHttpClient\Facades\Http::httpbin()->get('get', ['abc' => 'xyz']);

建议

为了 macros 的代码提示，建议新建一个 support/facade/Http 继承自 WebmanTech\LaravelHttpClient\Facades\Http，然后顶部添加注释用于代码提示

例如：

<?php namespace support\facade; use Illuminate\Http\Client\PendingRequest; /** * @method static PendingRequest httpbin() */ class Http extends \WebmanTech\LaravelHttpClient\Facades\Http { public static function getAllMacros(): array { return [ 'httpbin' => function() { return Http::baseUrl('https://httpbin.org') ->asJson(); } ]; } }

$response = \support\facade\Http::httpbin()->get('get', ['abc' => 'xyz']);