عرض مصدر PHP/ob end clean

<noinclude>{{DISPLAYTITLE:الدالة <code>ob_end_clean()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تنظف (تمسح) الدالة <code>ob_end_clean()‎</code> المخزنَ المؤقت للإخراج وتوقف التخزين المؤقت للإخراج.

== الوصف ==
<syntaxhighlight lang="php">
bool ob_end_clean ( void )
</syntaxhighlight>ستؤدي الدالة <code>ob_end_clean()‎</code> إلى حذف محتويات المخزن المؤقت للإخراج ذي أعلى مستوى (topmost) إضافةً إلى إغلاقه. إذا كنت تريد معالجة محتويات المخزن المؤقت فعليك استدعاء الدالة <code>ob_get_contents()</code>‎ قبل الدالة <code>ob_end_clean()‎</code> ذلك لأنه ستُحذف محتويات المخزن المؤقت عند استدعاء الدالة <code>ob_end_clean()</code>‎.

يجب بدء تشغيل المخزن المؤقت للإخراج بواسطة الدالة <code>ob_start()</code>‎ مع الرايتين  <code>PHP_OUTPUT_HANDLER_CLEANABLE</code> و<code>PHP_OUTPUT_HANDLER_REMOVABLE</code>. وإلا فلن تعمل الدالة <code>ob_end_clean()‎</code>.

== القيم المعادة ==
تُعيد الدالة <code>ob_end_clean()‎</code> القيمة  <code>TRUE</code> في حالة النجاح أو القيمة <code>FALSE</code> عند الفشل.

قد تفشل هذه الدالة بسبب استدعائها دون وجود مخزن مؤقت نشط، أو لأنها لم تستطع مسح المخزن المؤقت (وذلك ممكنٌ في حال كان المخزن المؤقت خاصًا).

== الأخطاء والاستثناءات ==
سيولّد تنبيهٌ من النوع <code>E_NOTICE</code> إذا فشل تنفيذ الدالة <code>ob_end_clean()‎</code>.

== أمثلة ==
يوضح المثال التالي طريقةً سهلةً للتخلص من كافة المخازن المؤقتة للإخراج:

المثال 1: مثال على الدالة <code>ob_end_clean()‎</code><syntaxhighlight lang="php">
<?php

ob_start();

echo 'Text that won\'t get displayed.';

ob_end_clean();

?>
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[PHP/ob start|ob_start()‎]]</code>: تشغيل التخزين المؤقت للإخراج.
* الدالة <code>[[PHP/ob get contents|ob_get_contents()‎]]</code>: إعادة محتويات المخزن المؤقت للإخراج.
* الدالة <code>[[PHP/ob flush|ob_flush()‎]]</code>: تدفق (إرسال) المخزن المؤقت للإخراج.

== مصادر ==
* [http://php.net/manual/en/function.ob-end-clean.php صفحة الدالة ob_end_clean‎ في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Output Control]]