poll
تابع poll در MySQLi برای «پایش اتصال ها (Poll)» است. یعنی چند اتصال را هم زمان بررسی می کند. سپس می گوید کدام اتصال آماده خواندن نتیجه است، کدام خطا دارد، و کدام رد شده است.
poll چه کاری انجام می دهد؟
تابع poll() سه فهرست اتصال می گیرد: خواندنی، خطادار، و ردشده. همچنین محدودیت انتظار بر ثانیه و میکروثانیه می گیرد. در پایان شمارش اتصال های آماده را برمی گرداند.
نحو (Syntax)
$mysqli->poll(read, error, reject, seconds, microseconds) یا mysqli_poll(read, error, reject, seconds, microseconds).
آرگومان ها
- read: فهرست اتصال ها برای نتیجه آماده خواندن.
- error: فهرست اتصال های دارای خطا یا قطع شده.
- reject: فهرست اتصال های بدون پرس وجوی غیرهمگام معتبر.
- seconds: حداکثر زمان انتظار بر ثانیه.
- microseconds: زمان انتظار اضافه بر میکروثانیه؛ پیش فرض صفر.
گام های عملی پایش اتصال ها
- فهرست اتصال ها را بساز.
- poll() را با محدودیت زمان صدا بزن.
- شمار آماده ها را بررسی کن و نتیجه ها را بخوان.
بازگشت و نسخه PHP
در موفقیت، تعداد اتصال های آماده برمی گردد. در شکست، FALSE برمی گردد. این تابع از PHP 5.3+ در دسترس است.
نکته و هشدار
نکته: زمان انتظار را منطقی بگذار تا برنامه گیر نکند.
هشدار: اتصال های «ردشده» یعنی برایشان پرس وجوی غیرهمگام معتبری ندارید.
برای مطالعه مرتبط: تابع poll، همچنین بررسی وضعیت با ping.
جمع بندی سریع
- poll چند اتصال را هم زمان پایش می کند.
- خروجی، تعداد اتصال های آماده است.
- سه فهرست می گیرد: read، error، reject.
- زمان انتظار ثانیه و میکروثانیه دارد.