الفرق بين المراجعتين ل"PHP/ob end flush"

من موسوعة حسوب
< PHP
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة ob_end_flush()‎ في PHP }}</noinclude>')
 
 
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE:الدالة ob_end_flush()‎ في PHP
 
<noinclude>{{DISPLAYTITLE:الدالة ob_end_flush()‎ في PHP
 
}}</noinclude>
 
}}</noinclude>
 +
(PHP 4, PHP 5, PHP 7)
 +
 +
تفرغ (ترسل) الدالة <code>ob_end_flush()‎</code> المخزن المؤقت للإخراج وتوقف التخزين المؤقت للإخراج.
 +
 +
== الوصف ==
 +
<syntaxhighlight lang="php">
 +
bool ob_end_flush (void)
 +
</syntaxhighlight>ترسل الدالة <code>()ob_end_flush</code> محتويات المخزن المؤقت للإخراج ذي أعلى مستوى (إن وجد) وتوقف عمل المخزن المؤقت للإخراج. إذا كنت ترغب كذلك في معالجة محتويات المخزن المؤقت، يجب عليك استدعاء الدالة <code>[[php/ob get contents|ob_get_contents()]]</code>‎ قبل الدالة <code>ob_end_flush()</code>‎ إذ تُحذَف محتويات المخزن المؤقت بعد استدعاء <code>ob_end_flush()</code>‎.
 +
 +
يجب أن يبدأ المخزن المؤقت للإخراج باستخدام الدالة <code>[[php/ob start|ob_start()]]</code>‎ مع الرايتين <code>PHP_OUTPUT_HANDLER_FLUSHABLE</code> و <code>PHP_OUTPUT_HANDLER_REMOVABLE</code>. بخلاف ذلك لن تعمل الدالة <code>ob_end_flush()</code>‎.
 +
 +
ملاحظة: هذه الدالة شبيهة بالدالة <code>[[php/ob get flush|ob_get_flush()]]</code>‎، باستثناء أنَّ الدالة <code>[[php/ob get flush|ob_get_flush()‎]]</code> تعيد المخزن المؤقت كسلسلة نصية.
 +
 +
== القيم المعادة ==
 +
تعيد الدالة <code>ob_end_flush()</code>‎ القيمة <code>TRUE</code> عند نجاحها والقيمة <code>FALSE</code> عند فشلها. أسباب الفشل هي استدعاء الدالة دون مخزن مؤقت نشط، أو أنه لسبب ما لا يمكن حذف المخزن المؤقت (يمكن أن يحدث ذلك عند إنشاء مخزن مؤقت خاص [special buffer]).
 +
 +
== الأخطاء والاستثناءات ==
 +
في حالة فشل الدالة <code>ob_end_flush()</code>‎، سيولّد تنبيهٌ من النوع <code>E_NOTICE</code>.
 +
 +
== أمثلة ==
 +
المثال 1: استعمال الدالة ob_end_flush‎()‎
 +
 +
يبين هذا المثال طريقة سهلة لإفراغ وإنهاء عمل كل المخازن المؤقتة للإخراج.<syntaxhighlight lang="php">
 +
<?php
 +
 +
 while (@ob_end_flush());
 +
 +
?>
 +
 +
 +
</syntaxhighlight>
 +
 +
== انظر أيضًا ==
 +
* الدالة <code>[[php/ob start|()ob_start]]</code>: تشغل المخزن المؤقت للإخراج.
 +
 +
* الدالة <code>[[php/ob get contents|()ob_get_contents]]</code>: ترجع محتويات المخزن المؤقت للإخراج.
 +
 +
* الدالة <code>[[php/ob get flush|()ob_get_flush]]</code>: تفرغ المخزن المؤقت للإخراج وترجعه على شكل سلسلة نصية مع إغلاق التخزين المؤقت للإخراج.
 +
 +
* الدالة <code>[[php/ob flush|()ob_flush]]</code>: تفرع (ترسل) المخزن المؤقت للإخراج.
 +
 +
* الدالة <code>[[PHP/ob end clean|()ob_end_clean]]</code>: تنظف (تفسخ) المخزن المؤقت للإخراج وتغلق التخزين المؤقت للإخراج.
 +
 +
== مصادر ==
 +
* [http://php.net/manual/en/function.session-abort.php صفحة الدالة ob_end_flush‎ في توثيق PHP الرسمي].
 +
[[تصنيف:PHP]]
 +
[[تصنيف:PHP Output Control ]]
 +
[[تصنيف:PHP Output Control Functions ]]

المراجعة الحالية بتاريخ 17:12، 27 يوليو 2018

(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: تنظف (تفسخ) المخزن المؤقت للإخراج وتغلق التخزين المؤقت للإخراج.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=PHP/ob_end_flush&oldid=13834"