PHP 開発: Guzzle を使用して HTTP クライアントを実装する

PHP 開発: Guzzle を使用して HTTP クライアントを実装する

PHP 開発プロセスでは、HTTP リクエストを伴うデータを取得するために外部サービスと通信する必要があることがよくあります。Guzzle は強力な PHP HTTP クライアントです。このツールは、HTTP リクエストを簡単に行うためのシンプルで使いやすい API を提供します。

この記事では、PHP 開発者が HTTP リクエストを迅速に実装できるように、Guzzle の基本的な使用法を紹介します。

1. Guzzle のインストール

Guzzle は Composer を通じてインストールできます。必要な作業は、プロジェクトのルート ディレクトリにあるcomposer.json ファイルに次のコンテンツを追加することだけです。

{
    "require": {
        "guzzlehttp/guzzle": "^7.0.0"
    }
}

次に、コマンド ラインで

composer install コマンドを実行して、Guzzle をインストールします。

HTTP リクエストの送信

Guzzle を使用して HTTP リクエストを送信するのは非常に簡単です。次に、GET リクエストの送信例を示します。

use GuzzleHttpClient;

$client = new Client();

$response = $client->request('GET', 'https://api.github.com/repos/guzzle/guzzle');

echo $response->getStatusCode(); // 200
echo $response->getHeaderLine('content-type'); // 'application/json; charset=utf8'
echo $response->getBody(); // '{"id": 1420053, "name": "guzzle", ...}'

この例では、Guzzle を使用して

Client インスタンスを作成し、GET リクエストを送信して Github の Guzzle プロジェクトにアクセスします。 API を使用して、$response オブジェクトを通じてリクエスト応答のステータス コード、応答ヘッダー、および応答本文の内容を取得します。それはとても簡単です！

上記は GET リクエストの例ですが、POST リクエストを作成するにはどうすればよいでしょうか? JSON データの送信を例に挙げます。

use GuzzleHttpClient;
use GuzzleHttpRequestOptions;

$client = new Client();

$response = $client->request('POST', 'http://httpbin.org/post', [
    RequestOptions::JSON => [
        'key' => 'value'
    ]
]);

echo $response->getStatusCode(); // 200
echo $response->getHeaderLine('content-type'); // 'application/json'
echo $response->getBody(); // '{ ... "data": "{"key":"value"}", ... }'

この例では、リクエスト メソッドを POST として指定し、リクエスト本文の JSON データを渡します。ここでは、Guzzle が提供する RequestOptions クラスを使用してリクエスト パラメーターを指定します。リクエスト パラメーターは、JSON、フォームなどのさまざまな形式で指定できます。

他の HTTP リクエスト メソッド (PUT、DELETE、PATCH など) は GET および POST リクエストに似ており、

$client->request の最初のパラメータで渡すだけで済みます。 () 対応するメソッドを入力するだけです。

Configuration Guzzle

基本的な使用法に加えて、Guzzle は HTTP リクエストをより適切に制御するのに役立つ豊富な構成オプションも提供します。一般的な構成オプションは次のとおりです。

(1) タイムアウト: リクエストのタイムアウト (秒単位)。

$client = new Client([
    'timeout' => 10
]);

(2) ヘッダー: カスタム リクエスト ヘッダー。

$client = new Client([
    'headers' => [
        'User-Agent' => 'MyApp/1.0'
    ]
]);

(3) クエリ: リクエストのクエリ パラメータ。配列または文字列にすることができます。

$client = new Client();

$response = $client->request('GET', 'https://api.github.com/search/repositories', [
    'query' => [
        'q' => 'php',
        'sort' => 'stars'
    ]
]);

(4) auth: 認証を要求します。基本認証または OAuth1.0 を使用できます。

$client = new Client();

$response = $client->request('GET', 'https://api.github.com/user', [
    'auth' => ['username', 'password']
]);

(5) verify: SSL 証明書を検証するかどうか。デフォルトは true です。

$client = new Client([
    'verify' => false
]);

(6) プロキシ: プロキシ設定。HTTP、HTTPS、または SOCKS5 プロキシにすることができます。

$client = new Client([
    'proxy' => 'http://user:pass@host:port'
]);

例外処理

HTTP リクエストを行うとき、DNS 解決エラーやリクエストのタイムアウトなど、いくつかの例外が発生する可能性があります。 Guzzle は、これらの例外を簡単にキャッチして処理できる例外処理メカニズムの完全なセットを提供します。

以下は簡単なエラー処理の例です:

use GuzzleHttpClient;
use GuzzleHttpExceptionRequestException;

$client = new Client();

try {
    $response = $client->request('GET', 'https://invalid-url.com');
} catch (RequestException $e) {
    echo $e->getMessage();
    if ($e->hasResponse()) {
        echo $e->getResponse()->getBody()->getContents();
    }
}

この例では、無効な URL にアクセスしようとします。Guzzle は RequestException 例外をスローします。例外エラーをキャッチすることで例外を取得できます。メッセージ。同時に、リクエスト応答が存在する場合は、

$e->getResponse() メソッドを通じて応答オブジェクトを取得できます。

概要

Guzzle は、強力な機能と柔軟な構成オプションを備えた優れた HTTP クライアント ツールであり、PHP 開発者が HTTP リクエストを迅速に実装するのに役立ちます。また、完全な例外も提供します。処理メカニズムを使用すると、リクエストのプロセス中に発生する例外を簡単にキャプチャして処理できるようになります。

以上、Guzzle の紹介と基本的な使い方を紹介しましたので、PHP 開発者の参考になれば幸いです。

以上がPHP 開発: Guzzle を使用して HTTP クライアントを実装するの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。