file_get_contents() (file_get_contents)
file_get_contents() برای «خواندن متن فایل PHP» عالی است. این تابع کل فایل را به یک «رشته (String)» می خواند. سرعت خوب است؛ چون از «مموری مپینگ (Memory Mapping)» کمک می گیرد.
سینتکس و کاربرد
تابع مسیر فایل را می گیرد و متن را برمی گرداند. می توانی از شروع مشخص بخوانی. همچنین می توانی طول خواندن را محدود کنی.
<?php
echo file_get_contents("test.txt");
?>
پارامترهای مهم
include_path: اگر 1 باشد، در include_path هم می گردد. context: مجموعه تنظیمات «استریم (Stream)». start: محل شروع خواندن؛ مقدار منفی یعنی از انتها. max_length: حداکثر بایت خوانده شده.
نمونه های کوتاه
مثال با محدودکردن طول داده:
<?php
echo file_get_contents("test.txt", false, null, 0, 20);
?>
مثال شروع از انتهای فایل:
<?php
echo file_get_contents("test.txt", false, null, -10);
?>
سه گام سریع
- مسیر فایل را مشخص کن.
- تابع را صدا بزن و خروجی بگیر.
- در صورت نیاز طول و شروع را تنظیم کن.
نکته: اگر فایل نبود، ابتدا با file_exists() چک کن. همچنین برای آرایه خطوط از file() استفاده کن. برای نوشتن متن، file_put_contents() مناسب است. عبارت کلیدی خواندن متن فایل PHP را در پروژه ها نگه دار.
جمع بندی سریع
- کل فایل را یک جا می خواند.
- شروع و طول قابل کنترل است.
- با include_path هم می گردد.
- برای متن سریع و ساده است.