El Componente HttpClient de Symfony será el reemplazo de Guzzle?

El componente **HttpClient de Symfony fue introducido en la versión 4.3** y aún esta considerado un feature experimental Nota a considerar antes de comenzar a usarlo en producción.

Una necesidad casi infalible en cada aplicación que desarrollamos, es el uso de una librería que nos provea un Cliente HTTP, que nos permita conectarnos al API de un tercero o en algunos casos para consumir nuestros propios API.

Así pues que no es de sorprenderse cuando se trata de nuevos componentes de Symfony ya que la visión del framework es siempre de proveernos de herramientas útiles las cuales nos permitan desarrollar nuestras aplicaciones de forma rápida, segura y sobre todo, escalable.

Estoy seguro de que este componente será el reemplazo de Guzzle no solo en proyectos hechos con Symfony si no en cualquier otro framework puesto que está pensado para trabajar desacoplado independientemente de donde se esté utilizando.

Instalación del Componente HttpClient de Symfony

Se requiere tener instalado Composer Requerimientos de instalación

Para instalar el componente debemos ejecutar el siguiente comando:

composer require symfony/http-client

Funcionalidades del Componente

A pesar de haber sido lanzado hace muy poco, este componente **HttpClient de Symfony** ya incorpora una numerosa cantidad de funcionalidades que desde ya podrás disponer de ellas.

Uso básico del componente

La clase Symfony\Component\HttpClient\HttpClient es la base para iniciar nuestras peticiones HTTP. Por lo cual podemos hacer uso de ella de la siguiente manera:

use Symfony\Component\HttpClient\HttpClient;

$httpClient = HttpClient::create();
$response = $httpClient->request('GET', 'https://api.github.com/repos/symfony/symfony-docs');

Una de las diferencias más importantes respecto a otros clientes HTTP es que el método request() es no bloqueante.

Esto quiere decir que, el objeto $**response** está disponible inmediatamente después de hacer la petición y el programa puede continuar su ejecución sin esperar una respuesta.

Cuando llames al método **getStatusCode(), la ejecución de la aplicación se detiene hasta que las cabeceras HTTP estén disponibles. Y si llamas al método `getContent()`**, se para hasta recibir todos los contenidos de la respuesta (aunque también puedes usar streaming en las respuestas):

$statusCode = $response->getStatusCode();
// $statusCode = 200

$contentType = $response->getHeaders()['content-type'][0];
// $contentType = 'application/json'

$content = $response->getContent();
// $content = '{"id":521583, "name":"symfony-docs", ...}'

$content = $response->toArray();
// $content = ['id' => 521583, 'name' => 'symfony-docs', ...]

Gracias a este comportamiento no bloqueante, es posible llamar varias veces al método **request()** para hacer peticiones asíncronas y acceder a las respuestas solo cuando se hayan realizado todas las peticiones.

Por defecto este componente utiliza las funciones nativas de PHP para realizar las peticiones, así que no tienes que instalar ninguna dependencia. No obstante, si en tu máquina has instalado/activado la librería cURL y la extensión cURL de PHP, entonces usará cURL automáticamente.

Si el código de estado HTTP de la respuesta no está en el rango 200- 299 (es decir, que es 3xx, 4xx o 5xx) tu aplicación deberar manejar el error, de lo contrario cuando ejecutes los métodos **getHeaders() y `getContent()`** verás una excepción:

// Esta petición devuelve un código de estado 403 en su respuesta.
$response = $httpClient->request('GET', 'https://httpbin.org/status/403');

// Si no compruebas el código de estado de la respuesta, verás una excepción de tipo
// Symfony\Component\HttpClient\Exception\ClientException 

$content = $response->getContent();

// Lo que debemos hacer es validad explícitamente el codigo de respuesta
// (en este caso, no se lanza ninguna excepción)
if (200 !== $response->getStatusCode()) {

    // handle the HTTP request error (e.g. retry the request)

} else {
    $content = $response->getContent();
}

Integración con Symfony

Si deseas utilizar el componente HttpClient de Symfony dentro del Framework, en lugar de usarlo como un componente desacoplado, puedes configurar la opción http_client en el fichero config/packages/framework.yaml:

# config/packages/framework.yaml
framework:
    # ...
    http_client:
        max_redirects: 7
        max_host_connections: 10

(echa un vistazo también a todas las opciones de configuración de HttpClient: Nota de referencia

Y ya con esto podrías hacer uso del Autowiring para inyectar el cliente **HttpClient de Symfony** en tus servicios o clases personalizadas:

use Symfony\Contracts\HttpClient\HttpClientInterface;

class SomeService
{
    private $httpClient;

    public function __construct(HttpClientInterface $httpClient)
    {
        $this->httpClient = $httpClient;
    }

    public function getRequest()
    {
        $response = $httpClient->request('GET', 'https://httpbin.org/status/403');

        if (200 !== $response->getStatusCode()) {

            // handle the HTTP request error (e.g. retry the request)

        } else {
            $content = $response->getContent();
        }

    }
}

Es todo por ahora con todo lo relacionado con este maravilloso componente HttpClient de Symfony. Estaré publicando actualizaciones a medida que el componente vaya incorporando nuevas funcionalidades.

Recuerda que si tienes alguna sugerencia o pregunta, no dudes en dejar tus comentarios al final del post.

Si te gustó este post, ayúdame a que pueda servirle a muchas más personas, compartiendo mis contenidos en tus redes sociales.

Espero que este post haya sido de gran ayuda para ti, y como siempre, cualquier inquietud o duda que tengas, puedes contactarme por cualquiera de las vías disponibles, o dejando tus comentarios al final de este post. También puedes sugerir que temas o post te gustaría leer a futuro.