Guzzle

کلاینت HTTP استاندارد PHP برای صدا زدن APIها

۴.۹۰ از ۵ PHP

این کتابخانه چیست و چه می‌کند؟

Guzzle پرکاربردترین کلاینت HTTP در اکوسیستم PHP است: درخواست‌های sync و async، middlewareها، ریتری و مدیریت کوکی و هدر. تقریباً هر SDK جدی PHP از Guzzle استفاده می‌کند و یادگیری آن برای کار با هر API خارجی ضروری است.

قابلیت‌های کلیدی

  • درخواست‌های sync و async با Promise
  • middleware برای لاگ، ریتری و کش
  • آپلود فایل و فرم چندبخشی
  • مدیریت خطا با استثناهای مشخص

مثال کاربردی واقعی

قابل اجرا
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.github.com', 'timeout' => 10]);

$response = $client->get('/repos/guzzle/guzzle');
$data = json_decode($response->getBody(), true);
echo $data['stargazers_count'];

$response = $client->post('https://httpbin.org/post', [
    'json' => ['name' => 'علی'],
]);
echo $response->getStatusCode();

توضیح مثال: همیشه timeout تعیین کنید تا درخواست‌های معلق اپ را بلاک نکنند؛ خطاهای 4xx و 5xx استثنای ClientException و ServerException می‌دهند که باید catch شوند.

نکات حرفه‌ای

  • برای چند درخواست هم‌زمان از Pool و async استفاده کنید.
  • middleware احراز هویت را یک‌بار به Client اضافه کنید تا در همه درخواست‌ها اعمال شود.