الدالة php_strip_whitespace()‎ في PHP

(PHP 5, PHP 7)

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

الوصف

string php_strip_whitespace ( string $filename )

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

العوامل

filename

المسار إلى ملف PHP.

القيم المعادة

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

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

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

أمثلة

المثال 1: مثال على الدالة php_strip_whitespace()‎

<?php

// PHP هنا تعليق

/*

*   هنا تعليق آخر

*/

echo        php_strip_whitespace(__FILE__);

// تعد الخطوط الجديدة مسافات بيضاء، وتُزال أيضًا

do_nothing();

?>

ناتج المثال السابق:

<?php

echo php_strip_whitespace(__FILE__); do_nothing(); ?>

لاحظ أن تعليقات PHP قد اختفت، كذلك المسافة البيضاء والسطر الجديد بعد جملة echo.

مصادر

• صفحة الدالة php_strip_whitespace‎ في توثيق PHP الرسمي.