الفرق بين المراجعتين ل"PHP/ob end flush"
رؤيا-بنعطية (نقاش | مساهمات) |
رؤيا-بنعطية (نقاش | مساهمات) |
||
| سطر 3: | سطر 3: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
| − | تفرغ (ترسل) الدالة ob_end_flush() المخزن المؤقت للإخراج وتوقف التخزين المؤقت للإخراج. | + | تفرغ (ترسل) الدالة <code>ob_end_flush()</code> المخزن المؤقت للإخراج وتوقف التخزين المؤقت للإخراج. |
== الوصف == | == الوصف == | ||
| + | <syntaxhighlight lang="php"> | ||
bool ob_end_flush (void) | 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> تعيد المخزن المؤقت كسلسلة نصية. | |
| − | |||
| − | ملاحظة: هذه الدالة شبيهة بالدالة ob_get_flush()، باستثناء أنَّ الدالة ob_get_flush() تعيد المخزن المؤقت كسلسلة نصية. | ||
== القيم المعادة == | == القيم المعادة == | ||
| − | تعيد الدالة ob_end_flush() القيمة TRUE عند نجاحها والقيمة FALSE عند فشلها. أسباب الفشل هي استدعاء الدالة دون مخزن مؤقت نشط، أو أنه لسبب ما لا يمكن حذف المخزن المؤقت (يمكن أن يحدث ذلك عند إنشاء مخزن مؤقت خاص [special buffer]). | + | تعيد الدالة <code>ob_end_flush()</code> القيمة <code>TRUE</code> عند نجاحها والقيمة <code>FALSE</code> عند فشلها. أسباب الفشل هي استدعاء الدالة دون مخزن مؤقت نشط، أو أنه لسبب ما لا يمكن حذف المخزن المؤقت (يمكن أن يحدث ذلك عند إنشاء مخزن مؤقت خاص [special buffer]). |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | في حالة فشل الدالة ob_end_flush()، سيولّد تنبيهٌ من النوع E_NOTICE. | + | في حالة فشل الدالة <code>ob_end_flush()</code>، سيولّد تنبيهٌ من النوع <code>E_NOTICE</code>. |
== أمثلة == | == أمثلة == | ||
المثال 1: استعمال الدالة ob_end_flush() | المثال 1: استعمال الدالة ob_end_flush() | ||
| − | يبين هذا المثال طريقة سهلة لإفراغ وإنهاء عمل كل المخازن المؤقتة للإخراج. | + | يبين هذا المثال طريقة سهلة لإفراغ وإنهاء عمل كل المخازن المؤقتة للإخراج.<syntaxhighlight lang="php"> |
| − | |||
<?php | <?php | ||
| سطر 30: | سطر 29: | ||
?> | ?> | ||
| + | |||
| + | |||
| + | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
مراجعة 17:07، 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(): تنظف (تفسخ) المخزن المؤقت للإخراج وتغلق التخزين المؤقت للإخراج.