الدالة ob_end_flush() في PHP
(PHP 4, PHP 5, PHP 7)
تفرغ (ترسل) الدالة ob_end_flush() المخزن المؤقت للإخراج وتوقف التخزين المؤقت للإخراج.
الوصف
bool ob_end_flush (void)
ترسل الدالة ()ob_end_flush محتويات المخزن المؤقت للإخراج ذي أعلى مستوى (إن وجد) وتوقف عمل المخزن المؤقت للإخراج. إذا كنت ترغب كذلك في معالجة محتويات المخزن المؤقت، يجب عليك استدعاء الدالة ob_get_contents() قبل الدالة ob_end_flush() إذ تُحذَف محتويات المخزن المؤقت بعد استدعاء ob_end_flush().
يجب أن يبدأ المخزن المؤقت للإخراج باستخدام الدالة ob_start() مع الرايتين PHP_OUTPUT_HANDLER_FLUSHABLE و PHP_OUTPUT_HANDLER_REMOVABLE. بخلاف ذلك لن تعمل الدالة ob_end_flush().
ملاحظة: هذه الدالة شبيهة بالدالة ob_get_flush()، باستثناء أنَّ الدالة ob_get_flush() تعيد المخزن المؤقت كسلسلة نصية.
القيم المعادة
تعيد الدالة ob_end_flush() القيمة TRUE عند نجاحها والقيمة FALSE عند فشلها. أسباب الفشل هي استدعاء الدالة دون مخزن مؤقت نشط، أو أنه لسبب ما لا يمكن حذف المخزن المؤقت (يمكن أن يحدث ذلك عند إنشاء مخزن مؤقت خاص [special buffer]).
الأخطاء والاستثناءات
في حالة فشل الدالة ob_end_flush()، سيولّد تنبيهٌ من النوع E_NOTICE.
أمثلة
المثال 1: استعمال الدالة ob_end_flush()
يبين هذا المثال طريقة سهلة لإفراغ وإنهاء عمل كل المخازن المؤقتة للإخراج.
<?php
while (@ob_end_flush());
?>
انظر أيضًا
- الدالة
()ob_start: تشغل المخزن المؤقت للإخراج.
- الدالة
()ob_get_contents: ترجع محتويات المخزن المؤقت للإخراج.
- الدالة
()ob_get_flush: تفرغ المخزن المؤقت للإخراج وترجعه على شكل سلسلة نصية مع إغلاق التخزين المؤقت للإخراج.
- الدالة
()ob_flush: تفرع (ترسل) المخزن المؤقت للإخراج.
- الدالة
()ob_end_clean: تنظف (تفسخ) المخزن المؤقت للإخراج وتغلق التخزين المؤقت للإخراج.