cr0/http-client

CR0 HTTP 客户端 - 专注于实用性和简单性的请求库

1.2.0 2024-04-20 17:29 UTC

This package is auto-updated.

Last update: 2024-09-20 22:58:36 UTC


README

您可以通过 Composer 安装此库。执行以下命令

bashCopy codecomposer require cr0/http-client

使用方法

基本使用

要开始使用 CR0 HTTP 客户端,请按照以下步骤操作

  1. 实例化客户端:创建一个客户端实例,传递您要访问的服务的基本 URL。

  2. 配置请求:根据需要设置头部、请求方法、查询参数和请求体。

  3. 发送请求:使用 send() 方法将请求发送到所需的端点。

  4. 获取响应:响应将作为一个 HttpResponse 对象返回,您可以从中提取身体、头部和状态码。

以下是一个基本使用的示例

phpCopy code<?php

use CR0<span class="hljs-title">HTTPClient<span class="hljs-title">Client; use CR0<span class="hljs-title">HTTPClient<span class="hljs-title">Api<span class="hljs-title">HttpResponse;

// Instancie o cliente com uma URL base $client = new Client('https://api.example.com');

// Defina cabeçalhos $client->setHeader([ 'Authorization' => 'Bearer SEU_TOKEN_DE_ACESSO', 'Content-Type' => 'application/json' ]);

// Defina o método da requisição $client->setMethod('POST');

// Adicione parâmetros de consulta (query) $client->addQuery('page', 1);

// Defina o corpo da requisição $client->setBody(json_encode(['key' => 'value']));

// Envie a requisição $response = $client->send('/endpoint');

// Obtenha o corpo da resposta $body = $response->getBody();

// Obtenha os cabeçalhos da resposta $headers = $response->getHeaders();

// Obtenha o código de status da resposta $status = $response->getStatusCode();

自定义

CR0 HTTP 客户端提供了多种自定义选项

  • 定义请求类型:您可以使用 isJson()isForm() 方法指定请求类型。

  • 处理重定向:使用 setMaxRedirect() 方法设置允许的最大重定向数。

  • 设置超时:您可以使用 setTimeout() 方法设置请求超时。

以下是如何使用这些选项的示例

phpCopy code$client->isJson(); // Define o tipo de requisição para JSON
$client->setMaxRedirect(3); // Permite no máximo 3 redirecionamentos
$client->setTimeout(30, 30); // Define o timeout e o timeout expirado para 30 segundos cada

贡献

欢迎贡献!如果您发现了一个错误,有建议或想添加新功能,请随意打开一个问题或发送一个拉取请求。

许可证

此库采用 MIT 许可证。您有权免费使用、修改和分发。

此 README 为 CR0 HTTP 客户端提供了一个详细的概述,包括详细的使用说明、自定义选项、贡献信息和许可证信息。请根据需要添加更多示例或信息。