دالة fgets() في PHP

وظائف نظام الملفات في PHP

التعريف والاستخدام

يقرأ دالة fgets() سطرًا واحدًا من إشارة ملف.

القواعد

fgets(file,length)
الم参数 وصف
file مطلوب. يحدد الملف الذي يجب قراءته.
length اختياري. يحدد عدد البايتات التي يجب قراءتها. الافتراضي هو 1024 بايت.

شرح

من file قراءة سطر واحد من الملف الذي يشير إليه ويعود بالنطاق الذي يصل إلى length - 1 بت من النص. إذا واجهت السطر النهائي (بما في ذلك في العودة)، أو EOF أو قمت بقراءة length - تتوقف بعد 1 بت (يتم اختيار الذي يظهر أولاً). إذا لم يتم تحديد length، فإن القيمة الافتراضية هي 1K، أو 1024 بت.

إذا فشلت، فإنها تعود بـ false.

النصائح والتعليقات

التعليقات:length الإعداد من PHP 4.2.0 أصبح اختياريًا، إذا تم تجاهله، يتم افتراض طول السطر على 1024 بت. من PHP 4.3، يمكن تجاهله length سيواصل من قراءة البيانات من النفق حتى نهاية السطر. إذا كانت معظم السطور في الملف أكبر من 8 KB، فإن تحديد طول السطر الأقصى في السكربت يكون أكثر فعالية في استهلاك الموارد.

التعليقات:من PHP 4.3 يمكن استخدام هذه الوظيفة بشكل آمن في الملفات الثنائية. الإصدارات المبكرة ليست كذلك.

التعليقات:إذا واجهت PHP مشكلة في معرفة خط النهاية للملفات Macintosh عند قراءة الملف، يمكنك تفعيل خيار التكوين Runtime auto_detect_line_endings.

مثال

مثال 1

<?php
$file = fopen("test.txt","r");
echo fgets($file);
fclose($file);
?>

الإخراج يشبه:

مرحبًا، هذا ملف اختباري.

مثال 2

<?php
$file = fopen("test.txt","r");
while(! feof($file))
  {
  echo fgets($file) . "<br />";
  }
fclose($file);
?>

الإخراج يشبه:

مرحبًا، هذا ملف اختباري. 
هناك ثلاثة أسطر هنا. 
هذا هو السطر الأخير.

وظائف نظام الملفات في PHP