عرض مصدر PHP/php strip whitespace

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

تعيد الدالةُ <code>php_strip_whitespace()</code>‎ مصدرَ الشيفرة مع إزالة التعليقات والمسافة البيضاء.

== الوصف ==
<syntaxhighlight lang="php">
string php_strip_whitespace ( string $filename )
</syntaxhighlight>تعيد الدالةُ <code>php_strip_whitespace()‎</code> شيفرة PHP المصدرية في المعامل <code>filename</code> بعد إزالة تعليقات PHP والمسافة البيضاء. قد يكون هذا مفيدًا لتحديد مقدار الشيفرة الفعلية في برامجك مقارنةً بكمية التعليقات. يشبه هذا استخدام <code>php -w</code> من سطر الأوامر.

== العوامل ==

=== <code>filename</code> ===
المسار إلى ملف PHP.

== القيم المعادة ==
ستعيد الدالةُ <code>php_strip_whitespace()</code>‎ شيفرة PHP المصدرية بعد إزالة تعليقات PHP والمسافة البيضاء بنجاح، وإلا فستعيد سلسلة نصية فارغة عند الفشل.

ملاحظة: تحترم الدالةُ <code>php_strip_whitespace()</code>‎ قيمة خيار الضبط <code>short_open_tag‎ ini</code>.

ملاحظة: تعمل الدالةُ <code>php_strip_whitespace()</code>‎ كما هو موضح في النسخة PHP 5.0.1. قبل هذا كانت تعيد فقط سلسلة نصية فارغة. لمزيد من المعلومات حول هذا الخطأ وسلوكه السابق، اطلع على صفحة العلّة ذات الرقم 29606#.

== أمثلة ==
المثال 1: مثال على الدالة <code>php_strip_whitespace()</code>‎<syntaxhighlight lang="php">
<?php
// PHP هنا تعليق
/*
*   هنا تعليق آخر
*/
echo        php_strip_whitespace(__FILE__);
// تعد الخطوط الجديدة مسافات بيضاء، وتُزال أيضًا
do_nothing();
?>
</syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang="text">
<?php
echo php_strip_whitespace(__FILE__); do_nothing(); ?>
</syntaxhighlight>لاحظ أن تعليقات PHP قد اختفت، كذلك المسافة البيضاء والسطر الجديد بعد جملة <code>[[PHP/echo|echo]]</code>.

== مصادر ==
* [http://php.net/manual/en/function.php-strip-whitespace.php صفحة الدالة php_strip_whitespace‎ في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Miscellaneous]]