Download the PHP package cr0/http-client without Composer

CR0 HTTP Client

O CR0 HTTP Client é uma biblioteca para realizar requisições HTTP de forma simples e prática. Ele oferece uma interface fácil de usar para fazer requisições HTTP com opções personalizáveis.

Instalação

Você pode instalar esta biblioteca via Composer. Execute o seguinte comando:

bashCopy code
composer require cr0/http-client

Uso

Uso Básico

Para começar a usar o CR0 HTTP Client, siga estas etapas:

1. Instancie o Cliente: Crie uma instância do cliente passando a URL base do serviço que você deseja acessar.

2. Configure a Requisição: Defina os cabeçalhos, o método da requisição, os parâmetros de consulta (query) e o corpo da requisição conforme necessário.

3. Envie a Requisição: Use o método send() para enviar a requisição para o endpoint desejado.

4. Obtenha a Resposta: A resposta será retornada como um objeto HttpResponse, do qual você pode extrair o corpo, os cabeçalhos e o código de status.

Aqui está um exemplo de uso básico:

phpCopy code
<?php

use CR0\HTTPClient\Client;
use CR0\HTTPClient\Api\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();

Personalização

O CR0 HTTP Client oferece várias opções de personalização:

• Definindo o Tipo de Requisição: Você pode especificar o tipo de requisição usando os métodos isJson() ou isForm().

• Lidando com Redirecionamentos: Defina o número máximo de redirecionamentos permitidos usando o método setMaxRedirect().

• Definindo Timeouts: Você pode definir timeouts de requisição usando o método setTimeout().

Aqui está um exemplo de como usar essas opções:

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

Contribuição

Contribuições são bem-vindas! Se você encontrou um bug, tem uma sugestão ou deseja adicionar uma nova funcionalidade, sinta-se à vontade para abrir uma issue ou enviar um pull request.

Licença

Esta biblioteca é licenciada sob a Licença MIT. Você tem permissão para usar, modificar e distribuir livremente.

Este README fornece uma visão geral detalhada da biblioteca CR0 HTTP Client, incluindo instruções detalhadas de uso, opções de personalização, informações de contribuição e informações de licenciamento. Sinta-se à vontade para expandir com mais exemplos ou informações conforme necessário.