file_put_contents() (file_put_contents)
با «file_put_contents» نوشتن در فایل خیلی راحت می شود. «نوشتن در فایل (File Write)» یعنی ذخیره متن داخل یک فایل. مثل دفتر مشق که جمله می نویسی. این تابع ساده است، اما دقیق کار می کند.
کاربرد و سینتکس
file_put_contents داده را در مسیر فایل می نویسد. اگر فایل نبود، ساخته می شود. خروجی تعداد بایت های نوشته شده است.
<?php
$bytes = file_put_contents("test.txt", "Hello World. Testing!");
echo $bytes;
?>
حالت ها (mode) و رفتار
«حالت (Mode)» یعنی تنظیم روش نوشتن. چند گزینه کلیدی داریم:
FILE_APPEND: افزودن به آخر فایل. جایگزین نکن.LOCK_EX: قفل نوشتن. هم زمانی را ایمن کن.FILE_USE_INCLUDE_PATH: جستجو در مسیر include.
افزودن بدون پاک شدن محتوا
برای لاگ مدرسه، همیشه باید خط جدید اضافه شود. پس از FILE_APPEND استفاده کن.
<?php
$data = "New line\n";
file_put_contents("log.txt", $data, FILE_APPEND);
?>
نوشتن ایمن با قفل
«قفل (Lock)» یعنی فقط یک نویسنده فعال باشد. این کار خطاهای هم زمانی را کم می کند.
<?php
$data = "Safe write\n";
file_put_contents("safe.txt", $data, LOCK_EX);
?>
گام های عملی سریع
- مسیر فایل را مشخص کن.
- متن یا داده را آماده کن.
- در صورت نیاز، حالت مناسب را تنظیم کن.
- تابع را اجرا کن و خروجی را بررسی کن.
نکته: اگر خروجی false بود، نوشتن انجام نشده است.
هشدار: بدون FILE_APPEND، محتوای قبلی پاک می شود.
پارامترها خلاصه
- filename: آدرس فایل مقصد.
- data: رشته، آرایه، یا استریم داده.
- mode: رفتار نوشتن و قفل.
- context: تنظیمات اضافی استریم.
جمع بندی سریع
- نوشتن در فایل سریع و ساده است.
- برای افزودن، از
FILE_APPENDاستفاده کن. - برای ایمنی،
LOCK_EXمفید است. - خروجی، تعداد بایت نوشته شده است.
- فایل نبود، ایجاد می شود.