الدالة 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 الرسمي.