الدالة sleep()‎ في 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()‎: تحديد الحد الأقصى لوقت التنفيذ.

مصادر

• صفحة الدالة sleep في توثيق PHP الرسمي.