{"id":25670,"date":"2021-06-04T11:40:00","date_gmt":"2021-06-04T08:40:00","guid":{"rendered":"https:\/\/themewp.inform.click\/?p=25670"},"modified":"2021-10-18T03:05:50","modified_gmt":"2021-10-18T00:05:50","slug":"come-utilizzare-guzzle-un-client-http-php-per-l-invio-di-richieste-http","status":"publish","type":"post","link":"https:\/\/themewp.inform.click\/it\/come-utilizzare-guzzle-un-client-http-php-per-l-invio-di-richieste-http\/","title":{"rendered":"Come utilizzare Guzzle: un client HTTP PHP per l’invio di richieste HTTP"},"content":{"rendered":"

Lo sviluppatore si imbatte sempre in un’attivit\u00e0 in cui deve inviare richieste HTTP ad altre risorse e gestire la risposta. Il modo pi\u00f9 diffuso per eseguire queste attivit\u00e0 \u00e8 utilizzare un cURL. Tuttavia, l’utilizzo del cURL non \u00e8 relativamente facile per un principiante. Inoltre, per scrivere uno script in cURL, il tuo server dovrebbe aver abilitato l’estensione cURL.<\/p>\n

Guzzle<\/a> \u00e8 un’alternativa a cURL. \u00c8 un client HTTP PHP che semplifica l’invio di richieste HTTP e banale l’integrazione con i servizi web. Anche, posso dire dalla mia esperienza che Guzzle \u00e8 meglio di cURL. \u00c8 semplice e facile da usare. Se stai usando Guzzle, non hai bisogno di avere l’estensione cURL sul tuo server. Ti offre una migliore formattazione del codice rispetto a cURL.<\/p>\n

Detto questo, vediamo come utilizzare Guzzle nella tua applicazione.<\/p>\n

Installazione<\/h3>\n

Il modo consigliato per installare Guzzle \u00e8 attraverso il Composer. Se non hai installato Composer sul tuo sistema, puoi scaricarlo da qui<\/a>.<\/p>\n

\"Come<\/a><\/p>\n

Apri il terminale nella directory principale del tuo progetto ed esegui il comando seguente per installare Guzzle.<\/p>\n

composer require guzzlehttp\/guzzle<\/code><\/pre>\n
Guzzle fornisce supporto per tutte le richieste HTTP che sono GET, DELETE, HEAD, OPTIONS, PATCH, POST e PUT. In questo tutorial, studiamo come utilizzare Guzzle per inviare richieste HTTP e gestire le risposte con esso.<\/p>\n
Ad esempio, prendo il servizio REQ|RES<\/a> che fornisce una falsa API reale per testare le richieste HTTP.<\/p>\n
Come inviare una richiesta HTTP utilizzando Guzzle<\/h3>\n
Al momento dell’installazione della libreria Guzzle, \u00e8 necessario includere un ambiente Guzzle nel file come segue.<\/p>\n
<?php\nrequire_once \"vendor\/autoload.php\";\n\u00a0\nuse GuzzleHttpClient;<\/code><\/pre>\n
Ora proviamo alcune operazioni una per una come GET, POST, Caricamento file, copia file dall’URL remoto a una directory locale, PUT, PATCH e DELETE.<\/p>\n
OTTIENI la richiesta usando Guzzle<\/h4>\n
Se guardi il sito web REQ|RES, hanno fornito alcuni endpoint per le richieste "GET". Prender\u00f2 l’esempio dell’endpoint ‘LIST USERS’. Per ottenere l’elenco degli utenti, chiedono di inviare una richiesta GET a questo endpoint https:\/\/reqres.in\/api\/users?page=2<\/a>.<\/p>\n
In Guzzle, invieremo questa richiesta GET come segue.<\/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
Per prima cosa ho estratto un "base_uri" (URL comune) come https:\/\/reqres.in<\/a>. Qui, l’endpoint finale \u00e8 "\/api\/users" e richiede un parametro GET come "pagina". In Guzzle, puoi inviare i parametri GET usando l’array ‘query’ come mostrato nel codice sopra.<\/p>\n
POST Richiesta utilizzando Guzzle<\/h4>\n
Normalmente, ci sono 2 tipi di richieste POST. Potrebbe essere necessario eseguire il POST dei parametri come richiesta POST "application\/x-www-form-urlencoded" o caricare i dati codificati JSON come corpo della richiesta. Puoi pubblicare dati codificati JSON come mostrato di seguito.<\/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
Nel caso della richiesta POST "application\/x-www-form-urlencoded", \u00e8 possibile eseguire il POST dei parametri come segue.<\/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
In alcuni casi, gli endpoint API ti chiedono di inviare il token di autorizzazione in ogni richiesta HTTP. L’utente pu\u00f2 inviare questo token come intestazioni nella tua richiesta 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
Copia file da server remoto usando Guzzle<\/h4>\n
Se stai cercando di copiare un file da un server remoto alla tua directory locale, Guzzle sar\u00e0 un’opzione migliore. Supponiamo che tu voglia copiare questa immagine su https:\/\/artisansweb.net\/wp-content\/uploads\/2020\/03\/blog.jpg<\/a> come "blog.jpg" nella tua directory locale. Scriveremo il codice per esso come mostrato di seguito.<\/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
Caricamento di file utilizzando Guzzle<\/h4>\n
Come tutti sappiamo, per caricare i file dobbiamo impostare il corpo della richiesta su un modulo ‘multipart\/form-data’. Il codice di base in Guzzle per caricare i file sarebbe scritto come di seguito.<\/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
Per dimostrare il caricamento del file, prender\u00f2 un esempio dal vivo dell’API<\/a> di reSmush.it<\/a> che invia una versione ottimizzata dell’immagine in risposta. Devi POSTARE la tua immagine al loro endpoint. Il codice per questo usando Guzzle come segue.<\/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 e DELETE Richiesta utilizzando Guzzle<\/h3>\n
Le richieste PUT e PATCH vengono utilizzate per aggiornare le risorse. Tuttavia, queste 2 richieste lo fanno in modo diverso.<\/p>\n
PUT sovrascrive l’intera entit\u00e0 se esiste gi\u00e0 e crea una nuova risorsa se non esiste. Se vuoi aggiornare il nome di una persona, devi inviare l’intera risorsa quando fai una richiesta 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 richiesta PATCH applica un aggiornamento parziale alla risorsa. Significa che devi solo inviare i dati che desideri aggiornare e questo non influenzer\u00e0 o cambier\u00e0 nient’altro. Quindi, se vuoi aggiornare il nome di una persona, ti verr\u00e0 richiesto solo di inviare il parametro name.<\/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 richiesta DELETE \u00e8 semplice. Hai solo bisogno di colpire l’endpoint come segue.<\/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
Spero che tu abbia avuto modo di conoscere Guzzle e le basi su come usarlo. Puoi leggere di pi\u00f9 sulle opzioni di richiesta Guzzle nella loro documentazione<\/a>. Si prega di condividere i tuoi pensieri o suggerimenti nella sezione commenti qui sotto.<\/p>\n
articoli Correlati<\/h4>\n