وظیفه file() در PHP

PHP Filesystem Functions

تعریف و استفاده

وظیفه file() این است که کل فایل را به یک آرایه بخواند.

با file_get_contents() مثل، اما فرق این است که file() فایل را به عنوان یک آرایه بازمی‌گرداند. هر عنصر آرایه، خطی از فایل است، از جمله کلیدهای خط.

اگر ناامد، درهیچ صورت به درست نیاید.

قوانین

file(path,include_path,context)
پارامتر توضیح
path ضروری. فایلی که باید خوانده شود را مشخص می‌کند.
include_path اختیاری. اگر می‌خواهید فایل‌ها را در include_path نیز جستجو کنید، می‌توانید این پارامتر را به "1" تنظیم کنید.
context

اختیاری. محیط دسترسی به فایل را مشخص می‌کند.

context یک مجموعه از تنظیمات است که می‌توانند رفتار جریان را تغییر دهند. اگر null استفاده شود، نادیده گرفته می‌شود.

توضیح

برای context پشتیبانی از آن در PHP 5.0.0 اضافه شده است.

در هر خط از آرایه‌ای که بازمی‌گردانده شده، خط‌پایان نیز وجود دارد، بنابراین اگر خط‌پایان مورد نیاز نیست، باید از فونکشن rtrim() استفاده شود.

توضیحات و کامنت‌ها

توضیح:از PHP 4.3.0 به بعد، می‌توان با file_get_contents() فایل را به یک رشته خوانده و برگرداند.

توضیح:از PHP 4.3.0 به بعد، file() می‌تواند به طور امن برای فایل‌های باینری استفاده شود.

توضیح:اگر PHP در خواندن فایل نتواند خط‌پایان فایل‌های Macintosh را شناسایی کند، می‌توانید تنظیمات اجرایی auto_detect_line_endings را فعال کنید.

مثال

<?php
print_r(file("test.txt"));
?>

خروجی:

Array
(
[0] => Hello World. Testing testing!
[1] => Another day, another line.
[2] => If the array picks up this line,
[3] => then is it a pickup line?
)

PHP Filesystem Functions