PHP fgets() 函数

PHP Filesystem Functions

定义和用法

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 در هنگام خواندن فایل نتواند خط‌پایان مکینتاش را شناسایی کند، می‌توانید گزینه پیکربندی زمانی 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 Filesystem Functions