الفرق بين المراجعتين ل"PHP/ob end clean"
رؤيا-بنعطية (نقاش | مساهمات) |
رؤيا-بنعطية (نقاش | مساهمات) (إضافات و تعديلات تنسيقية) |
||
| سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
| − | تنظف (تمسح) الدالة ob_end_clean() المخزنَ المؤقت للإخراج وتوقف التخزين المؤقت للإخراج. | + | تنظف (تمسح) الدالة <code>ob_end_clean()</code> المخزنَ المؤقت للإخراج وتوقف التخزين المؤقت للإخراج. |
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
bool ob_end_clean ( void ) | bool ob_end_clean ( void ) | ||
| − | </syntaxhighlight>ستؤدي الدالة ob_end_clean() إلى حذف محتويات المخزن المؤقت للإخراج ذي أعلى مستوى (topmost) إضافةً إلى إغلاقه. إذا كنت تريد معالجة محتويات المخزن المؤقت فعليك استدعاء الدالة ob_get_contents() قبل الدالة ob_end_clean() ذلك لأنه ستُحذف محتويات المخزن المؤقت عند استدعاء الدالة ob_end_clean(). | + | </syntaxhighlight>ستؤدي الدالة <code>ob_end_clean()</code> إلى حذف محتويات المخزن المؤقت للإخراج ذي أعلى مستوى (topmost) إضافةً إلى إغلاقه. إذا كنت تريد معالجة محتويات المخزن المؤقت فعليك استدعاء الدالة <code>ob_get_contents()</code> قبل الدالة <code>ob_end_clean()</code> ذلك لأنه ستُحذف محتويات المخزن المؤقت عند استدعاء الدالة <code>ob_end_clean()</code>. |
| − | يجب بدء تشغيل المخزن المؤقت للإخراج بواسطة الدالة ob_start() مع الرايتين | + | يجب بدء تشغيل المخزن المؤقت للإخراج بواسطة الدالة <code>ob_start()</code> مع الرايتين <code>PHP_OUTPUT_HANDLER_CLEANABLE</code> و<code>PHP_OUTPUT_HANDLER_REMOVABLE</code>. وإلا فلن تعمل الدالة <code>ob_end_clean()</code>. |
== القيم المعادة == | == القيم المعادة == | ||
| − | تُعيد الدالة ob_end_clean() القيمة | + | تُعيد الدالة <code>ob_end_clean()</code> القيمة <code>TRUE</code> في حالة النجاح أو القيمة <code>FALSE</code> عند الفشل. |
قد تفشل هذه الدالة بسبب استدعائها دون وجود مخزن مؤقت نشط، أو لأنها لم تستطع مسح المخزن المؤقت (وذلك ممكنٌ في حال كان المخزن المؤقت خاصًا). | قد تفشل هذه الدالة بسبب استدعائها دون وجود مخزن مؤقت نشط، أو لأنها لم تستطع مسح المخزن المؤقت (وذلك ممكنٌ في حال كان المخزن المؤقت خاصًا). | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | سيولّد تنبيهٌ من النوع E_NOTICE إذا فشل تنفيذ الدالة ob_end_clean(). | + | سيولّد تنبيهٌ من النوع <code>E_NOTICE</code> إذا فشل تنفيذ الدالة <code>ob_end_clean()</code>. |
== أمثلة == | == أمثلة == | ||
يوضح المثال التالي طريقةً سهلةً للتخلص من كافة المخازن المؤقتة للإخراج: | يوضح المثال التالي طريقةً سهلةً للتخلص من كافة المخازن المؤقتة للإخراج: | ||
| − | المثال 1: مثال على الدالة ob_end_clean()<syntaxhighlight lang="php"> | + | المثال 1: مثال على الدالة <code>ob_end_clean()</code><syntaxhighlight lang="php"> |
<?php | <?php | ||
| سطر 35: | سطر 35: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة ob_start(): تشغيل التخزين المؤقت للإخراج. | + | * الدالة <code>[[PHP/ob start|ob_start()]]</code>: تشغيل التخزين المؤقت للإخراج. |
| − | * الدالة ob_get_contents(): إعادة محتويات المخزن المؤقت للإخراج. | + | * الدالة <code>[[PHP/ob get contents|ob_get_contents()]]</code>: إعادة محتويات المخزن المؤقت للإخراج. |
| − | * الدالة ob_flush(): تدفق (إرسال) المخزن المؤقت للإخراج. | + | * الدالة <code>[[PHP/ob flush|ob_flush()]]</code>: تدفق (إرسال) المخزن المؤقت للإخراج. |
== مصادر == | == مصادر == | ||
مراجعة 22:32، 26 مايو 2018
(PHP 4, PHP 5, PHP 7)
تنظف (تمسح) الدالة ob_end_clean() المخزنَ المؤقت للإخراج وتوقف التخزين المؤقت للإخراج.
الوصف
bool ob_end_clean ( void )
ستؤدي الدالة ob_end_clean() إلى حذف محتويات المخزن المؤقت للإخراج ذي أعلى مستوى (topmost) إضافةً إلى إغلاقه. إذا كنت تريد معالجة محتويات المخزن المؤقت فعليك استدعاء الدالة ob_get_contents() قبل الدالة ob_end_clean() ذلك لأنه ستُحذف محتويات المخزن المؤقت عند استدعاء الدالة ob_end_clean().
يجب بدء تشغيل المخزن المؤقت للإخراج بواسطة الدالة ob_start() مع الرايتين PHP_OUTPUT_HANDLER_CLEANABLE وPHP_OUTPUT_HANDLER_REMOVABLE. وإلا فلن تعمل الدالة ob_end_clean().
القيم المعادة
تُعيد الدالة ob_end_clean() القيمة TRUE في حالة النجاح أو القيمة FALSE عند الفشل.
قد تفشل هذه الدالة بسبب استدعائها دون وجود مخزن مؤقت نشط، أو لأنها لم تستطع مسح المخزن المؤقت (وذلك ممكنٌ في حال كان المخزن المؤقت خاصًا).
الأخطاء والاستثناءات
سيولّد تنبيهٌ من النوع E_NOTICE إذا فشل تنفيذ الدالة ob_end_clean().
أمثلة
يوضح المثال التالي طريقةً سهلةً للتخلص من كافة المخازن المؤقتة للإخراج:
المثال 1: مثال على الدالة ob_end_clean()
<?php
ob_start();
echo 'Text that won\'t get displayed.';
ob_end_clean();
?>
انظر أيضًا
- الدالة
ob_start(): تشغيل التخزين المؤقت للإخراج. - الدالة
ob_get_contents(): إعادة محتويات المخزن المؤقت للإخراج. - الدالة
ob_flush(): تدفق (إرسال) المخزن المؤقت للإخراج.