</>مدرسه زیب‌موجیاد بگیر، تمرین کن، بساز
مدرسهPHPدرس 28
درس 28 از 80 · ۶۵ دقیقه

درخواست HTTP با cURL، Timeout و خطای شبکه

ارتباط شبکه ممکن است کند، قطع یا نامعتبر باشد. باید Timeout، وضعیت HTTP، خطای انتقال و اعتبار پاسخ را جدا مدیریت کنیم.

۰امتیاز شما
نقشه این درس

بعد از این درس دقیقاً چه بلدی؟

  • موضوع «Connect timeout» را با زبان ساده برای فرد دیگری توضیح می‌دهی.
  • مثال همین درس را خط‌به‌خط می‌خوانی و خروجی آن را پیش‌بینی می‌کنی.
  • کد را تغییر می‌دهی، نتیجه یا ساختار آن را بررسی می‌کنی و خطا را مرحله‌ای اصلاح می‌کنی.
به زبان زندگی واقعی

تماس با پشتیبانی

ممکن است خط اشغال باشد، کسی پاسخ ندهد یا پاسخ اشتباه باشد. هر حالت پیام و تصمیم متفاوتی می‌خواهد.

نکته مهم برای شروع PHP

ارتباط شبکه ممکن است کند، قطع یا نامعتبر باشد. باید Timeout، وضعیت HTTP، خطای انتقال و اعتبار پاسخ را جدا مدیریت کنیم.

چرا مهم است؟ این مفهوم یکی از آجرهای مسیر حرفه‌ای PHP است. فعلاً لازم نیست همه جزئیات را حفظ کنی؛ باید دلیل استفاده و اثر هر خط را بفهمی.

اولین تمرین تو: برنامه حداکثر چند ثانیه منتظر می‌ماند، وضعیت 200 را بررسی و سپس JSON را اعتبارسنجی می‌کند.

مفهوم‌های اصلی

اول بفهم، بعد کد بنویس

Connect timeout

مدت انتظار برای برقراری اتصال را محدود می‌کند.

HTTP status

نتیجه منطقی پاسخ را مستقل از موفقیت شبکه نشان می‌دهد.

Retry

فقط برای شکست موقت و عملیات امن، با فاصله افزایشی انجام می‌شود.

سناریوی واقعی

دریافت نرخ ارز از API

برنامه حداکثر چند ثانیه منتظر می‌ماند، وضعیت 200 را بررسی و سپس JSON را اعتبارسنجی می‌کند.

ورودی روشنقانون قابل توضیحخروجی قابل بررسی
بازی ساختن کد

قطعه‌ها را به ترتیب درست بچین

روی هر قطعه بزن تا وارد پاسخ شود؛ برای برگرداندن دوباره روی آن بزن. با دکمه‌های جابه‌جایی هم می‌توانی بدون کشیدن و رهاکردن ترتیب را اصلاح کنی.

مرحله ۲ از ۳ · مرتب‌کردن کد
بانک قطعه‌هاقطعه مناسب را انتخاب کن
ترتیب پاسخ تواز بالا به پایین اجرا می‌شود

    هنوز پاسخی بررسی نشده است.

    کارگاه تعاملی

    کد را کامل کن و ساختار آن را بررسی کن

    این درس وارد قابلیت‌های سروری یا حرفه‌ای شده است. برای امنیت سایت، کد دلخواه روی سرور اجرا نمی‌شود؛ بررسی‌گر، وجود اجزای ضروری و منطق مورد انتظار را کنترل می‌کند و راهنمای اصلاح می‌دهد.

    lesson-28.php
    گزارش بررسیبررسی‌گر ساختار آماده است
    کد را کامل کن و «بررسی ساختار» را بزن.
    در مثال‌های پیشرفته، اجرای ناامن سروری نداریم؛ اجزای ضروری کد بررسی می‌شوند.
    کدخوانی استاد

    این مثال خط‌به‌خط چه می‌گوید؟

    فعلاً حفظ نکن؛ هر خط را به یک جمله ساده تبدیل کن.

    1. 1<?php

      از اینجا مفسر PHP شروع به خواندن کد می‌کند.

    2. 2$curl = curl_init("https://example.com/api/rates");

      یک مقدار با نام $curl نگه‌داری می‌شود تا در خط‌های بعد دوباره استفاده شود.

    3. 3curl_setopt_array($curl, [

      این خط بخشی از منطق اصلی مثال است؛ نام‌ها و علامت‌ها را از راست به چپ، بخش‌به‌بخش بخوان.

    4. 4CURLOPT_RETURNTRANSFER => true,

      این خط بخشی از منطق اصلی مثال است؛ نام‌ها و علامت‌ها را از راست به چپ، بخش‌به‌بخش بخوان.

    5. 5CURLOPT_CONNECTTIMEOUT => 3,

      این خط بخشی از منطق اصلی مثال است؛ نام‌ها و علامت‌ها را از راست به چپ، بخش‌به‌بخش بخوان.

    6. 6CURLOPT_TIMEOUT => 8,

      این خط بخشی از منطق اصلی مثال است؛ نام‌ها و علامت‌ها را از راست به چپ، بخش‌به‌بخش بخوان.

    7. 7]);

      این خط بخشی از منطق اصلی مثال است؛ نام‌ها و علامت‌ها را از راست به چپ، بخش‌به‌بخش بخوان.

    8. 8$body = curl_exec($curl);

      یک مقدار با نام $body نگه‌داری می‌شود تا در خط‌های بعد دوباره استفاده شود.

    9. 9if ($body === false) {

      یک پرسش درست/نادرست بررسی می‌شود و مسیر اجرای بعدی را تعیین می‌کند.

    10. 10throw new RuntimeException(curl_error($curl));

      این خط بخشی از منطق اصلی مثال است؛ نام‌ها و علامت‌ها را از راست به چپ، بخش‌به‌بخش بخوان.

    11. 11}

      مرز یک بلوک یا فراخوانی در اینجا باز یا بسته می‌شود.

    منبع رسمی همین درسمستندات اصلی PHP را ببین ←برای عمیق‌ترشدن؛ لازم نیست در شروع همه آن را بخوانی.
    حالا نوبت توست

    بررسی status code، decode JSON و یک Retry محدود برای خطای 503 اضافه کن.

    تمرین پلکانی

    از ساده به چالشی، بدون پرش

    ۱ · گرم‌کردن

    یکی از مقدارهای مثال را عوض کن، خروجی را روی کاغذ حدس بزن و سپس بررسی کن.

    ۲ · تثبیت

    بررسی status code، decode JSON و یک Retry محدود برای خطای 503 اضافه کن.

    ۳ · ساختن

    سناریوی «دریافت نرخ ارز از API» را با نام‌های واضح‌تر و یک حالت تازه گسترش بده.

    دام‌های رایج

    این سه اشتباه را انجام نده

    1

    درخواست بدون Timeout

    2

    Retry بی‌نهایت یا روی عملیات غیرقابل تکرار

    3

    اعتماد به JSON بدون بررسی status و schema

    آزمون پایان درس

    5 پرسش کوتاه؛ مطمئن شو واقعاً یاد گرفته‌ای

    برای هر پرسش یک پاسخ انتخاب کن. بعد از هر انتخاب، دلیل پاسخ را همان‌جا می‌بینی.

    پرسش 1 از 5

    چرا CURLOPT_TIMEOUT ضروری است؟

    پرسش 2 از 5

    کدام توضیح، «Connect timeout» را دقیق‌تر بیان می‌کند؟

    پرسش 3 از 5

    بهترین قدم بعد از خواندن مثال این درس چیست؟

    پرسش 4 از 5

    کدام روش نشان می‌دهد این درس را واقعاً فهمیده‌ای؟

    پرسش 5 از 5

    کدام رفتار احتمال خطا را در همین موضوع بیشتر می‌کند؟

    پایان درس 28

    درس را فقط وقتی تمام کن که کد را تغییر داده‌ای

    دیدن آموزش کافی نیست؛ یک مقدار را تغییر بده، خروجی را پیش‌بینی کن و بعد اجرا بزن.