تابع file() PHP

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

تابع file() تمام فایل را به یک آرایه می‌خواند.

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

در صورت شکست، برمی‌گردد به false.

ترتیب

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

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

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

توضیح

برای مستند پشتیبانی از آن در 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] => سلام دنیا. تست تست!
[1] => روز دیگر، خط دیگری.
[2] => اگر آرایه این خط را انتخاب کند،
[3] => آیا این یک خط عاشقانه است؟
)