Network Request

The Network class is a utility designed to simplify making HTTP requests to external resources such as APIs, web services, or websites. It provides an easy-to-use interface for sending HTTP requests and handling responses, including accessing response headers, status codes, and response bodies.

By default, it uses cURL for making HTTP requests, but it also supports the Guzzle client for those who prefer it.

• Class namespace: \Luminova\Http\Network
• This class implements:\Luminova\Interface\NetworkInterface

Methods

Before you dive into the network implementation, also take a look at the response interface Network Response Object.

constructor

Constructor for NetworkInterface.

public __construct(\Luminova\Interface\HttpClientInterface|null $client = null): mixed

Parameters:

getClient

Get the HTTP client instance.

public getClient(): \Luminova\Interface\HttpClientInterface

Return Value:

\Luminova\Interface\HttpClientInterface - The HTTP client instance.

send

Send a request.

public send(string $method, string $url, array $data = [], array $headers = []): \Luminova\Http\Message\Response

Parameters:

Return Value:

\Luminova\Http\Message\Response - The response from the request.

Throws:

• \Luminova\Exceptions\RequestException - If there is an error making the request.
• \Luminova\Exceptions\ConnectException - If there is an error connecting to the server.
• \Luminova\Exceptions\ClientException - If there is an error on the client side.
• \Luminova\Exceptions\ServerException - If there is an error on the server side.

get

Perform a GET request.

public get(string $url, array $data = [], array $headers = []): \Luminova\Http\Message\Response

Parameters:

Return Value:

\Luminova\Http\Message\Response - The response from the request.

Throws:

• \Luminova\Exceptions\RequestException - If there is an error making the request.
• \Luminova\Exceptions\ConnectException - If there is an error connecting to the server.
• \Luminova\Exceptions\ClientException - If there is an error on the client side.
• \Luminova\Exceptions\ServerException - If there is an error on the server side.

fetch

Fetch data using a GET request.

public fetch(string $url, array $headers = []): \Luminova\Http\Message\Response

Parameters:

Return Value:

\Luminova\Http\Message\Response - The response from the request.

Throws:

• \Luminova\Exceptions\RequestException - If there is an error making the request.
• \Luminova\Exceptions\ConnectException - If there is an error connecting to the server.
• \Luminova\Exceptions\ClientException - If there is an error on the client side.
• \Luminova\Exceptions\ServerException - If there is an error on the server side.

post

Perform a POST request.

public post(string $url, array $data = [], array $headers = []): \Luminova\Http\Message\Response

Parameters:

Return Value:

\Luminova\Http\Message\Response - The response from the request.

Throws:

• \Luminova\Exceptions\RequestException - If there is an error making the request.
• \Luminova\Exceptions\ConnectException - If there is an error connecting to the server.
• \Luminova\Exceptions\ClientException - If there is an error on the client side.
• \Luminova\Exceptions\ServerException - If there is an error on the server side.

request

Perform a request.

public request(string $method, string $url, array $data = [], array $headers = []): \Luminova\Http\Message\Response

Parameters:

Return Value:

\Luminova\Http\Message\Response - The response from the request.

Throws:

• \Luminova\Exceptions\RequestException - If there is an error making the request.
• \Luminova\Exceptions\ConnectException - If there is an error connecting to the server.
• \Luminova\Exceptions\ClientException - If there is an error on the client side.
• \Luminova\Exceptions\ServerException - If there is an error on the server side.

sendAsync

Send a request asynchronously.

public sendAsync(\GuzzleHttp\Psr7\Request $request): \GuzzleHttp\Promise\PromiseInterface

Parameters:

Return Value:

\GuzzleHttp\Promise\PromiseInterface - A promise that resolves with the response.

Examples

Send network request using default Curl client.

<?php 
use \Luminova\Http\Network;
use \Luminova\Exceptions\AppException;
use \Exception;

$network = new Network();

try{
    $response = $network->get('https://example.com/api/foo');
    $statusCode = $response->getStatusCode();
    $content = $response->getContents();
} catch (AppException | Exception $e) {
    echo $e->getMessage();
}

Send a network request using Guzzle.

<?php 
use \Luminova\Http\Network;
use \Luminova\Http\Client\Guzzle;
use \Luminova\Exceptions\AppException;
use \Exception;

$network = new Network(new Guzzle());

try{
    $response = $network->get('https://example.com/api/foo');
    $statusCode = $response->getStatusCode();
    $content = $response->getContents();
} catch (AppException | Exception $e) {
    echo $e->getMessage();
}