webman-tech/laravel-http-client

Webman plugin webman-tech/laravel-http-client

v1.3.1 2024-04-10 15:23 UTC

This package is auto-updated.

Last update: 2024-10-10 16:34:22 UTC


README

Laravel illuminate/http 中的 HttpClient for webman

介绍

站在巨人(laravel)的肩膀上使 http 请求使用更加可靠便捷

所有方法和配置与 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 栏目可以配置日志相关

默认未启用

支持配置各种情况日志:

  • 仅记录响应状态码为 2xx/3xx/4xx/5xx 类型的日志
  • 仅记录慢请求
  • 不同响应码记录不同 log level
  • 不同响应码记录不同 log channel
  • 替换请求日志中的敏感信息
  • 自动截取部分请求或响应的 body,防止日志过大
  • 自动忽略请求或相应是 file 的,防止日志过大

默认的 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']);