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

من موسوعة حسوب
< PHP
اذهب إلى: تصفح، ابحث

(PHP 4, PHP 5, PHP 7)

تَجلُب الدالة fgetss()‎ سطرًا واحدًا من ملف معيَّن وتزيل وسوم HTML من النصِّ الذي تقرؤه.

الوصف

string fgetss ( resource $handle [, int $length [, string$allowable_tags ]] )
تشبه هذه الدالة تمامًا الدالة fgets()‎ باستثناء أنَّها تحاول إزالة بايتات العدم (NULL)، ووسوم HTML، ووسوم PHP التي تعثر عليها أثناء قراءتها للنص.

المعاملات

handle

مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم يُغلق بعد باستعمال الدالة fclose()‎.

length

طول البيانات المراد إعادتها.

allowable_tags

معامل اختياري. يحدِّد الوسوم المسموح بتواجدها أي التي لن تُحذف من النص. راجع صفحة الدالة strip_tags()‎ للمزيد من المعلومات المتعلقة بهذا المعامل.

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

تُعاد سلسلة نصيَّة ذات الطول length - 1 بايت التي قُرئت من الملف الذي يشير إليه المورد handle. إن لم يعد هنالك بيانات تُقرأ من الملف المشار إليه، فستُعاد القيمة FALSE.

إن حصل أي خطأ، فستُعاد القيمة FALSE.

أمثلة

المثال 1: استعمال الدالة fgetss()‎ لقراءة كلِّ سطر على حدة من أسطر ملف PHP
<?php
$str = <<<EOD
<html><body>
 <p>Welcome! Today is the <?php echo(date('jS')); ?> of <?= date('F'); ?>.</p>
</body></html>
Text outside of the HTML block.
EOD;
file_put_contents('sample.php', $str);

$handle = @fopen("sample.php", "r");
if ($handle) {
    while (!feof($handle)) {
        $buffer = fgetss($handle, 4096);
        echo $buffer;
    }
    fclose($handle);
}
?>
سيُظهر المثال السابق النتيجة التالية:
Welcome! Today is the  of .

Text outside of the HTML block.

ملاحظات

إن لم تتعرَّف PHP على نهاية السطر عند قراءة ملفات موجودة على نظام Macintosh أو أُنشأت باستعماله، ففعِّل خيار auto_detect_line_endings من ضبط التشغيل (runtime configuration) إذ سيساعد ذلك على حلِّ المشكلة.

انظر أيضًا

  • الدالة fopen()‎: تفتح ملفًا أو عنوان URL.
  • الدالة popen()‎: تفتح عمليَّة وتشير إليها بمؤشر شبيه بمؤشر ملف.
  • الدالة fsockopen()‎: تفتح اتصالًا بالإنترنت أو بمقبس نطاق يونكس (Unix domain socket).
  • الدالة fgets()‎: تجلب سطرًا من ملف.
  • الدالة strip_tags()‎: تزيل وسوم HTML ووسوم PHP من سلسلة نصيَّة.

مصادر