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