الفرق بين المراجعتين لصفحة: «PHP/fgetss»

المراجعة الحالية بتاريخ 03:53، 22 أبريل 2018

(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 من سلسلة نصيَّة.

مصادر

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

@@ سطر 59: / سطر 59: @@
 * الدالة <code>[[PHP/fsockopen|fsockopen()‎]]</code>: تفتح اتصالًا بالإنترنت أو بمقبس نطاق يونكس (Unix domain socket).
 * الدالة <code>[[PHP/fgets|fgets()‎]]</code>: تجلب سطرًا من ملف.
-* الدالة <code>[[PHP/strip tags|strip_tags()‎]]</code>: تزيل وسوم [[HTML]] ووسوم [[PHP]] من [[PHP/String|سلسلة نصيَّة]].
+* الدالة <code>[[PHP/strip tags|strip_tags()‎]]</code>: تزيل وسوم [[HTML]] ووسوم [[PHP]] من [[PHP/string|سلسلة نصيَّة]].
 == مصادر ==
 * [http://php.net/manual/en/function.fgetss.php صفحة الدالة fgetss في توثيق PHP الرسمي.]
 [[تصنيف:PHP]]
+[[تصنيف:PHP Function]]
 [[تصنيف:PHP Filesystem]]
-[[تصنيف:PHP Function]]