تابع PHP file_get_contents()
تعریف و استفاده
تابع file_get_contents() تمام محتوای فایل را به یک رشته میخواند.
و file() مانند آن، اما تفاوت این است که file_get_contents() فایل را به یک رشته میخواند.
تابع file_get_contents() یکی از روشهای پیشنهادی برای خواندن محتوای یک فایل به یک رشته است. اگر سیستم عامل پشتیبانی کند، از تکنیکهای نقشهبرداری حافظه نیز برای بهبود عملکرد استفاده میشود.
نحوهی استفاده
file_get_contents(path,include_path,context,start,max_length)
پارامترها | توضیح |
---|---|
path | ضروری. فایلی که باید خوانده شود را مشخص میکند. |
include_path | اختیاری. اگر میخواهید فایل در include_path نیز جستجو شود، این پارامتر را به "1" تنظیم کنید. |
context |
اختیاری. محیط دسترسی به فایل را مشخص میکند. context مجموعهای از گزینههایی است که میتوانند رفتار جریان را تغییر دهند. اگر null استفاده شود، نادیده گرفته میشود. |
start | اختیاری. موقعیت شروع خواندن در فایل را مشخص میکند. این پارامتر در PHP 5.1 اضافه شده است. |
max_length | اختیاری. تعداد بایتهایی که باید خوانده شود را مشخص میکند. این پارامتر در PHP 5.1 اضافه شده است. |
توضیح
برای context پشتیبانی از پارامترها در PHP 5.0.0 اضافه شده است.
توضیحات و نکات
نکته:این تابع میتواند به طور ایمن برای اشیاء دودویی استفاده شود.
مثال
<?php echo file_get_contents("test.txt"); ؟>
خروجی:
این یک فایل آزمایشی با متن آزمایشی است.