{"id":28977,"date":"2021-06-04T11:22:00","date_gmt":"2021-06-04T08:22:00","guid":{"rendered":"https:\/\/themewp.inform.click\/?p=28977"},"modified":"2021-10-17T16:29:02","modified_gmt":"2021-10-17T13:29:02","slug":"como-utilizar-guzzle-un-cliente-http-php-para-enviar-solicitudes-http","status":"publish","type":"post","link":"https:\/\/themewp.inform.click\/es\/como-utilizar-guzzle-un-cliente-http-php-para-enviar-solicitudes-http\/","title":{"rendered":"C\u00f3mo utilizar Guzzle: un cliente HTTP PHP para enviar solicitudes HTTP"},"content":{"rendered":"

El desarrollador siempre se encuentra con una tarea en la que necesita enviar solicitudes HTTP a otros recursos y manejar la respuesta. La forma popular de realizar estas tareas es mediante el uso de un cURL. Sin embargo, usar cURL no es relativamente f\u00e1cil para un principiante. Adem\u00e1s, para escribir un script en cURL, su servidor deber\u00eda haber habilitado la extensi\u00f3n cURL.<\/p>\n

Guzzle<\/a> es una alternativa a cURL. Es un cliente HTTP de PHP que facilita el env\u00edo de solicitudes HTTP y simplifica la integraci\u00f3n con los servicios web. Incluso, puedo decir por mi experiencia que Guzzle es mejor que cURL. Es simple y f\u00e1cil de usar. Si est\u00e1 utilizando Guzzle, no necesita tener la extensi\u00f3n cURL en su servidor. Le brinda un mejor formato de c\u00f3digo en comparaci\u00f3n con cURL.<\/p>\n

Dicho esto, veamos c\u00f3mo usar Guzzle en su aplicaci\u00f3n.<\/p>\n

Instalaci\u00f3n<\/h3>\n

La forma recomendada de instalar Guzzle es a trav\u00e9s de Composer. Si no ha instalado Composer en su sistema, puede obtenerlo desde aqu\u00ed<\/a>.<\/p>\n

\"C\u00f3mo<\/a><\/p>\n

Abra la terminal en el directorio ra\u00edz de su proyecto y ejecute el siguiente comando para instalar Guzzle.<\/p>\n

composer require guzzlehttp\/guzzle<\/code><\/pre>\n
Guzzle proporciona soporte para todas las solicitudes HTTP que son GET, DELETE, HEAD, OPTIONS, PATCH, POST y PUT. En este tutorial, estudiamos c\u00f3mo usar Guzzle para enviar solicitudes HTTP y manejar respuestas con \u00e9l.<\/p>\n
Como ejemplo, tomo el servicio REQ | RES<\/a> que proporciona una API real falsa para probar solicitudes HTTP.<\/p>\n
C\u00f3mo enviar una solicitud HTTP usando Guzzle<\/h3>\n
Tras la instalaci\u00f3n de la biblioteca Guzzle, debe incluir un entorno Guzzle en su archivo de la siguiente manera.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\nuse GuzzleHttpClient;<\/code><\/pre>\n
Ahora intentemos algunas operaciones una por una como GET, POST, carga de archivo, copia de archivo de URL remota a un directorio local, PUT, PATCH y DELETE.<\/p>\n
OBTENER Solicitud usando Guzzle<\/h4>\n
Si observa el sitio web de REQ | RES, proporcionaron algunos puntos finales para las solicitudes ‘GET’. Tomar\u00e9 el ejemplo del punto final ‘LIST USERS’. Para obtener la lista de usuarios, solicitan enviar una solicitud GET a este punto final https:\/\/reqres.in\/api\/users?page=2<\/a>.<\/p>\n
En Guzzle, enviaremos esta solicitud GET de la siguiente manera.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\n$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0'base_uri' => 'https:\/\/reqres.in',\n]);\n\u00a0\u00a0\n$response = $client->request('GET', '\/api\/users', [\n\u00a0\u00a0\u00a0\u00a0'query' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'page' => '2',\n\u00a0\u00a0\u00a0\u00a0]\n]);\n\u00a0\n\/\/get status code using $response->getStatusCode();\n\u00a0\n$body = $response->getBody();\n$arr_body = json_decode($body);\nprint_r($arr_body);<\/code><\/pre>\n
Primero extraje un ‘base_uri’ (URL com\u00fan) como https:\/\/reqres.in<\/a>. Aqu\u00ed, el extremo final es ‘\/ api \/ users’ y requiere un par\u00e1metro GET como ‘p\u00e1gina’. En Guzzle, puede enviar par\u00e1metros GET utilizando la matriz ‘consulta’ como se muestra en el c\u00f3digo anterior.<\/p>\n
Solicitud POST usando Guzzle<\/h4>\n
Normalmente, existen 2 tipos de solicitudes POST. Es posible que necesite POST par\u00e1metros como solicitud POST ‘application \/ x-www-form-urlencoded’ o cargar datos codificados JSON como un cuerpo de la solicitud. Puede publicar datos codificados en JSON como se muestra a continuaci\u00f3n.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\n$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0'base_uri' => 'https:\/\/reqres.in',\n]);\n\u00a0\n$response = $client->request('POST', '\/api\/users', [\n\u00a0\u00a0\u00a0\u00a0'json' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'name' => 'Sam',\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'job' => 'Developer'\n\u00a0\u00a0\u00a0\u00a0]\n]);\n\u00a0\n\/\/get status code using $response->getStatusCode();\n\u00a0\n$body = $response->getBody();\n$arr_body = json_decode($body);\nprint_r($arr_body);<\/code><\/pre>\n
En el caso de la solicitud POST ‘application \/ x-www-form-urlencoded’, puede POST par\u00e1metros de la siguiente manera.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\n$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0'base_uri' => 'BASE_URL_ENDPOINT',\n]);\n\u00a0\n$client->request('POST', '\/endpoint_here', [\n\u00a0\u00a0\u00a0'form_params' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'foo' => 'bar',\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'baz' => ['hi', 'there!']\n\u00a0\u00a0\u00a0]\n]);<\/code><\/pre>\n
En algunos casos, los puntos finales de la API le piden que env\u00ede un token de autorizaci\u00f3n en cada solicitud HTTP. El usuario puede enviar este token como encabezados en su solicitud de Guzzle.<\/p>\n
<?php\n$client->request('POST', '\/endpoint_here', [\n\u00a0\u00a0\u00a0\u00a0\"headers\" => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"Authorization\" => \"Bearer TOKEN_VALUE\"\n\u00a0\u00a0\u00a0\u00a0],\n\u00a0\u00a0\u00a0\u00a0'form_params' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'foo' => 'bar',\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'baz' => ['hi', 'there!']\n\u00a0\u00a0\u00a0\u00a0]\n]);<\/code><\/pre>\n
Copie el archivo desde el servidor remoto usando Guzzle<\/h4>\n
Si est\u00e1 buscando copiar un archivo desde un servidor remoto a su directorio local, Guzzle ser\u00e1 una mejor opci\u00f3n. Supongamos que desea copiar esta imagen en https:\/\/artisansweb.net\/wp-content\/uploads\/2020\/03\/blog.jpg<\/a> como ‘blog.jpg’ en su directorio local. Escribiremos el c\u00f3digo como se muestra a continuaci\u00f3n.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\n$fp = fopen('blog.jpg', 'wb');\n\u00a0\n$client = new GuzzleHttpClient();\n$request = $client->get('https:\/\/artisansweb.net\/wp-content\/uploads\/2020\/03\/blog.jpg', ['sink' => $fp]);\n\u00a0\nfclose($fp);<\/code><\/pre>\n
Carga de archivos usando Guzzle<\/h4>\n
Como todos sabemos, para cargar archivos necesitamos establecer el cuerpo de la solicitud en un formulario ‘multipart \/ form-data’. El c\u00f3digo b\u00e1sico en Guzzle para cargar archivos se escribir\u00eda como se muestra a continuaci\u00f3n.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\n$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0'base_uri' => 'BASE_URL_HERE',\n]);\n\u00a0\n$client->request('POST', '\/endpoint_here', [\n\u00a0\u00a0\u00a0\u00a0'multipart' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0[\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'name'\u00a0\u00a0\u00a0\u00a0 => 'files', \/\/ name value requires by endpoint\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'contents' => fopen('\/path\/to\/file', 'r'),\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'filename' => 'custom_image.jpg'\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0],\n\u00a0\u00a0\u00a0\u00a0]\n]);<\/code><\/pre>\n
Para demostrar la carga del archivo, tomar\u00e9 un ejemplo en vivo de la API reSmush.it<\/a> que env\u00eda una versi\u00f3n optimizada de la imagen en respuesta. Necesita PUBLICAR su imagen en su punto final. El c\u00f3digo para usar Guzzle de la siguiente manera.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\ntry {\n\u00a0\u00a0\u00a0\u00a0$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'base_uri' => 'http:\/\/api.resmush.it',\n\u00a0\u00a0\u00a0\u00a0]);\n\u00a0\n\u00a0\u00a0\u00a0\u00a0$response = $client->request('POST', \"?qlty=92\", [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'multipart' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0[\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'name'\u00a0\u00a0\u00a0\u00a0 => 'files', \/\/ name value requires by endpoint\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'contents' => fopen(getcwd().'\/blog.jpg', 'r'),\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'filename' => 'blog.jpg',\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'headers'\u00a0 => array('Content-Type' => mime_content_type(getcwd().'\/blog.jpg'))\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0]\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0]\n\u00a0\u00a0\u00a0\u00a0]);\n\u00a0\n\u00a0\u00a0\u00a0\u00a0if (200 == $response->getStatusCode()) {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$response = $response->getBody();\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$arr_result = json_decode($response);\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0print_r($arr_result);\n\u00a0\u00a0\u00a0\u00a0}\n} catch (Exception $e) {\n\u00a0\u00a0\u00a0\u00a0echo $e->getMessage();\n}<\/code><\/pre>\n
PUT, PATCH y DELETE Request usando Guzzle<\/h3>\n
Las solicitudes PUT y PATCH se utilizan para actualizar los recursos. Sin embargo, estas 2 solicitudes lo hacen de manera diferente.<\/p>\n
PUT sobrescribe toda la entidad si ya existe y crea un nuevo recurso si no existe. Si desea actualizar el nombre de una persona, debe enviar el recurso completo al realizar una solicitud PUT.<\/p>\n
<?php\n<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\u00a0\n$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0'base_uri' => 'https:\/\/reqres.in',\n]);\n\u00a0\u00a0\n$response = $client->request('PUT', '\/api\/users\/2', [\n\u00a0\u00a0\u00a0\u00a0'json' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'name' => 'Sam',\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'job' => 'Developer'\n\u00a0\u00a0\u00a0\u00a0]\n]);\n\u00a0\u00a0\n\/\/get status code using $response->getStatusCode();\n\u00a0\n$body = $response->getBody();\n$arr_body = json_decode($body);\nprint_r($arr_body);<\/code><\/pre>\n
La solicitud PATCH aplica una actualizaci\u00f3n parcial al recurso. Significa que solo debe enviar los datos que desea actualizar y no afectar\u00e1 ni cambiar\u00e1 nada m\u00e1s. Entonces, si desea actualizar el nombre de una persona, solo se le pedir\u00e1 que env\u00ede el par\u00e1metro de nombre.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\u00a0\n$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0'base_uri' => 'https:\/\/reqres.in',\n]);\n\u00a0\u00a0\n$response = $client->request('PATCH', '\/api\/users\/2', [\n\u00a0\u00a0\u00a0\u00a0'json' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'name' => 'Sam',\n\u00a0\u00a0\u00a0\u00a0]\n]);\n\u00a0\u00a0\n\/\/get status code using $response->getStatusCode();\n\u00a0\n$body = $response->getBody();\n$arr_body = json_decode($body);\nprint_r($arr_body);<\/code><\/pre>\n
Una solicitud DELETE es sencilla. Solo necesita llegar al punto final de la siguiente manera.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\u00a0\nuse GuzzleHttpClient;\n\u00a0\u00a0\n$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0'base_uri' => 'https:\/\/reqres.in',\n]);\n\u00a0\u00a0\n$response = $client->request('DELETE', '\/api\/users\/2');\n\u00a0\u00a0\necho $response->getStatusCode(); \/\/should gives 204<\/code><\/pre>\n
Espero que conozcas Guzzle y los conceptos b\u00e1sicos de c\u00f3mo usarlo. Puede leer m\u00e1s sobre las opciones de solicitud de Guzzle en su documentaci\u00f3n<\/a>. Comparta sus pensamientos o sugerencias en la secci\u00f3n de comentarios a continuaci\u00f3n.<\/p>\n
Art\u00edculos relacionados<\/h4>\n