الدالة sleep() في PHP
< PHP
(PHP 4, PHP 5, PHP 7)
تُأَخِّرُ الدالةُ sleep() تنفيذَ البرنامج.
الوصف
int sleep ( int $seconds )
تُأَخِّرُ الدالةُ sleep() تنفيذ البرنامج لعدد محدد من الثواني.
المعاملات
seconds
زمن الإيقاف بالثواني.
القيم المعادة
تعيد الدالة sleep() القيمة 0 عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ.
إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة sleep() قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة WAIT_IO_COMPLETION ثابتة داخل ويندوز API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف.
الأخطاء والاستثناءات
إذا كان عدد الثواني المحدد سالبًا، فستنشئ الدالة تنبيهًا من النوع E_WARNING.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 5.3.4 | قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ sleep() القيمة NULL عند عملها على نظام التشغيل ويندوز بغض النظر هل قُوطعت العملية أم لا.
|
أمثلة
المثال 1: مثال على الدالة sleep()
<?php
// الوقت الحالي
echo date('h:i:s') . "\n";
// تأخير التنفيذ لمدة 10 ثوان
sleep(10);
// استيقظ!
echo date('h:i:s') . "\n";
?>
ناتج المثال السابق:
05:31:23
05:31:33
انظر أيضًا
- الدالة
usleep(): تأخير التنفيذ مدةً تُقدر بالميكروثانية. - الدالة
time_nanosleep(): تأخير لعدد من الثواني والنانوثانية. - الدالة
time_sleep_until(): تأخير البرنامج حتى الوقت المحدد. - الدالة
set_time_limit(): تحديد الحد الأقصى لوقت التنفيذ.