Pembangunan PHP: menggunakan Guzzle untuk melaksanakan klien HTTP

Pembangunan PHP: Gunakan Guzzle untuk melaksanakan klien HTTP

Semasa proses pembangunan PHP, selalunya perlu untuk berkomunikasi dengan perkhidmatan luaran untuk mendapatkan data, yang melibatkan permintaan HTTP, dan Guzzle ialah klien HTTP PHP yang berkuasa alat, yang menyediakan API yang ringkas dan mudah digunakan untuk membuat permintaan HTTP dengan mudah.

Artikel ini akan memperkenalkan penggunaan asas Guzzle untuk membantu pembangun PHP melaksanakan permintaan HTTP dengan pantas.

1. Pasang Guzzle

Guzzle boleh dipasang melalui Composer Anda hanya perlu menambah kandungan berikut pada fail composer.json dalam direktori akar projek:

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

Kemudian laksanakan perintah composer install dalam baris arahan untuk memasang Guzzle.

2. Menghantar Permintaan HTTP

Menghantar permintaan HTTP adalah sangat mudah dengan Guzzle. Berikut ialah contoh menghantar permintaan 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", ...}'

Dalam contoh ini, kami menggunakan Guzzle untuk mencipta contoh Client, kemudian menghantar permintaan GET untuk mengakses API projek Guzzle pada Github, dan kemudian Kami memperoleh kod status, pengepala respons dan kandungan badan respons bagi respons permintaan melalui objek $response. Semudah itu!

Di atas adalah contoh permintaan GET, jadi bagaimana untuk membuat permintaan POST? Ambil penghantaran data JSON sebagai contoh:

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"}", ... }'

Dalam contoh ini, kami menentukan kaedah permintaan sebagai POST dan lulus dalam data JSON badan permintaan. Kelas RequestOptions yang disediakan oleh Guzzle digunakan di sini untuk menentukan parameter permintaan Parameter permintaan boleh dalam pelbagai bentuk seperti JSON, borang, dll.

Kaedah permintaan HTTP lain (seperti PUT, DELETE, PATCH, dll.) adalah serupa dengan permintaan GET dan POST Anda hanya perlu menghantar kaedah yang sepadan dalam parameter pertama $client->request().

3. Mengkonfigurasi Guzzle

Selain penggunaan asas, Guzzle juga menyediakan pilihan konfigurasi yang kaya yang boleh membantu kami mengawal permintaan HTTP dengan lebih baik. Berikut ialah beberapa pilihan konfigurasi biasa:

(1) tamat masa: minta tamat masa, dalam saat.

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

(2) pengepala: Pengepala permintaan tersuai.

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

(3) pertanyaan: parameter pertanyaan permintaan, yang boleh menjadi tatasusunan atau rentetan.

$client = new Client();

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

(4) pengesahan: Minta pengesahan, yang boleh menjadi pengesahan asas atau OAuth1.0.

$client = new Client();

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

(5) sahkan: Sama ada untuk mengesahkan sijil SSL, lalai adalah benar.

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

(6) proksi: tetapan proksi, yang boleh menjadi proksi HTTP, HTTPS atau SOCKS5.

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

4. Pengendalian pengecualian

Apabila membuat permintaan HTTP, beberapa pengecualian mungkin berlaku, seperti ralat resolusi DNS, tamat masa permintaan, dsb. Guzzle menyediakan set lengkap mekanisme pengendalian pengecualian yang boleh menangkap dan mengendalikan pengecualian ini dengan mudah.

Berikut ialah contoh pengendalian ralat mudah:

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();
    }
}

Dalam contoh ini, kami cuba mengakses URL yang tidak sah, Guzzle akan membuang pengecualian RequestException, kami boleh mendapatkannya dengan menangkap ralat pengecualian mesej. Pada masa yang sama, jika respons permintaan wujud, objek respons boleh diperolehi melalui kaedah $e->getResponse().

5. Ringkasan

Guzzle ialah alat klien HTTP yang sangat baik dengan fungsi berkuasa dan pilihan konfigurasi yang fleksibel, yang boleh membantu pembangun PHP melaksanakan permintaan HTTP dengan pantas. Ia juga menyediakan pengecualian lengkap mekanisme pengendalian, membolehkan kami menangkap dan mengendalikan pengecualian yang berlaku semasa proses permintaan dengan mudah.

Di atas adalah pengenalan dan penggunaan asas Guzzle. Saya harap ia akan membantu pembangun PHP.

Atas ialah kandungan terperinci Pembangunan PHP: menggunakan Guzzle untuk melaksanakan klien HTTP. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!