آموزش جامع خواندن و نوشتن فایل متنی در PHP (به زبان ساده)

مقدمه‌ای بر کار با فایل‌ها در PHP

در دنیای توسعه وب، مدیریت و کار با فایل‌ها اهمیت بسیار زیادی دارد. از ذخیره‌سازی لاگ‌های سیستم گرفته تا ساخت فایل‌های پیکربندی و ذخیره اطلاعات موقت، همگی نیازمند تسلط بر مفاهیم خواندن و نوشتن فایل هستند. زبان برنامه‌نویسی PHP ابزارهای قدرتمند و متنوعی را برای مدیریت فایل‌ها در اختیار توسعه‌دهندگان قرار می‌دهد. در این مقاله، استانداردترین روش‌ها را برای خواندن و نوشتن فایل‌های متنی بررسی می‌کنیم.

روش ساده و سریع: کار با فایل به صورت یکجا

اگر فایل شما حجم کوچکی دارد و می‌خواهید کل محتوای آن را به یکباره بخوانید یا تغییر دهید، استفاده از توابع تک‌خطی PHP بهترین و بهینه‌ترین گزینه است.

۱. خواندن فایل با تابع file_get_contents

این تابع کل محتویات یک فایل متنی را خوانده و آن را به صورت یک رشته (String) بازمی‌گرداند. استفاده از این تابع بسیار ساده است:

$filename = "example.txt";

if (file_exists($filename)) {
    $content = file_get_contents($filename);
    echo "محتوای فایل: " . nl2br($content);
} else {
    echo "فایل مورد نظر یافت نشد!";
}

۲. نوشتن در فایل با تابع file_put_contents

این تابع برای نوشتن سریع داده‌ها درون فایل استفاده می‌شود. به صورت پیش‌فرض، این تابع محتویات قبلی فایل را پاک کرده و داده جدید را جایگزین می‌کند. اما با استفاده از پرچم FILE_APPEND می‌توانید داده جدید را به انتهای فایل اضافه کنید:

$filename = "example.txt";
$data = "این یک متن نمونه برای ذخیره در فایل است.\n";

// بازنویسی کامل فایل
file_put_contents($filename, $data);

// اضافه کردن به انتهای فایل قبلی
$additional_data = "این متن به انتهای فایل اضافه می‌شود.\n";
file_put_contents($filename, $additional_data, FILE_APPEND);

echo "داده‌ها با موفقیت ذخیره شدند.";

روش پیشرفته و حرفه‌ای: استفاده از Resource Handler (جریان فایل)

برای فایل‌های بزرگ یا کنترل دقیق‌تر بر روی فرآیند خواندن و نوشتن (مانند خواندن خط به خط فایل)، باید از توابع fopen، fwrite و fclose استفاده کنیم.

باز کردن فایل با تابع fopen

این تابع فایل را باز کرده و یک اشاره‌گر (Pointer) ایجاد می‌کند. این تابع به دو پارامتر نیاز دارد: نام فایل و حالت دسترسی (Mode):

• r (Read): فایل را فقط برای خواندن باز می‌کند.
• w (Write): فایل را برای نوشتن باز می‌کند. فایل را خالی کرده و اگر فایل وجود نداشته باشد، آن را می‌سازد.
• a (Append): فایل را برای نوشتن باز می‌کند اما اشاره‌گر را به انتهای فایل می‌برد تا داده جدید به آخر فایل اضافه شود.

مثال عملی نوشتن در فایل با روش پیشرفته:

$filename = "log.txt";
$file_pointer = fopen($filename, "w");

if ($file_pointer) {
    $text = "ثبت گزارش در تاریخ: " . date("Y-m-d H:i:s") . "\n";
    fwrite($file_pointer, $text);
    fclose($file_pointer); // همیشه پس از اتمام کار، فایل را ببندید
    echo "گزارش با موفقیت ثبت شد.";
} else {
    echo "امکان باز کردن فایل وجود ندارد.";
}

مثال عملی خواندن خط به خط فایل متنی:

خواندن فایل به صورت خط به خط با استفاده از تابع fgets برای فایل‌های با حجم بالا بسیار کارآمد است، زیرا تمام فایل را یکجا در حافظه RAM بارگذاری نمی‌کند:

$filename = "log.txt";
$file_pointer = fopen($filename, "r");

if ($file_pointer) {
    while (($line = fgets($file_pointer)) !== false) {
        echo htmlspecialchars($line) . "";
    }
    fclose($file_pointer);
} else {
    echo "خطا در باز کردن فایل!";
}

نکات امنیتی بسیار مهم در کار با فایل‌ها

هنگام کار با سیستم فایل (File System)، رعایت اصول امنیتی برای جلوگیری از آسیب‌پذیری‌هایی نظیر Local File Inclusion (LFI) بسیار حیاتی است:

1. اعتبارسنجی نام فایل: هرگز به کاربر اجازه ندهید نام یا مسیر فایلی را به طور مستقیم از طریق پارامترهای GET یا POST مشخص کند.
2. بررسی سطح دسترسی (Permissions): مطمئن شوید فایل‌های حساس شما روی سرور دسترسی عمومی برای خواندن یا اجرا شدن ندارند.
3. استفاده از توابع امن: از تابع is_writable() و file_exists() پیش از انجام عملیات نوشتن و خواندن برای جلوگیری از بروز خطاهای بحرانی استفاده کنید.

$filename = "secure_data.txt";

if (file_exists($filename) && is_writable($filename)) {
    // انجام عملیات نوشتن ایمن
} else {
    echo "فایل وجود ندارد یا قابل نوشتن نیست!";
}

نتیجه‌گیری

در این مقاله با اصول خواندن و نوشتن فایل‌های متنی در زبان PHP آشنا شدید. برای کارهای ساده، توابع file_get_contents و file_put_contents بهترین انتخاب و برای سناریوهای پیشرفته‌تر، استفاده از توابع جریان محور نظیر fopen کارآمدتر هستند. همیشه امنیت مسیرها و سطح دسترسی فایل‌ها را در پروژه‌های واقعی خود اولویت اول قرار دهید.

پیشنمایش