تابع 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");
؟>

خروجی:

این یک فایل آزمایشی با متن آزمایشی است.