ฟังก์ชัน fgets() ของ PHP

ฟังก์ชัน Filesystem 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 ในระหว่างการอ่านแฟ้ม สามารถประกาศตัวแปรการปรับเปลี่ยนไฟล์บรรทัดสุดท้ายแบบทันที auto_detect_line_endings ของการปรับแต่งปฏิบัติการ

ตัวอย่าง

ตัวอย่าง 1

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

การแสดงผลคล้ายนี้:

Hello, this is a test file.

ตัวอย่าง 2

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

การแสดงผลคล้ายนี้:

Hello, this is a test file. 
There are three lines here. 
This is the last line.

ฟังก์ชัน Filesystem PHP