دستور file_put_contents در زبان برنامهنویسی PHP یکی از توابع کارآمد و مفید برای نوشتن محتوا به فایل است. این تابع به شما اجازه میدهد تا محتوای متغیر یا رشتهای را در یک فایل ذخیره کنید. این تابع میتواند بسیار مفید باشد زمانی که شما نیاز دارید تا اطلاعاتی را در فایلی ذخیره کنید، مانند ذخیره کردن دادههای فرم، ایجاد فایلهای لاگ و غیره.
ساختار کلی تابع file_put_contents به صورت زیر است:
file_put_contents(نام_فایل, محتوا, فلگ)
در این ساختار، پارامتر اول نام فایل است که میخواهید محتوا را در آن ذخیره کنید. پارامتر دوم محتوایی است که میخواهید در فایل ذخیره شود. و در نهایت، پارامتر سوم فلگ است که مشخص میکند چگونه فایل را باز کنید و چگونه محتوا را در آن ذخیره کنید. مقدار پیشفرض این پارامتر “0” است که به معنی این است که فایل باز میشود و محتوا در آن ذخیره میشود. اما میتوانید از فلگهای دیگری مانند “FILE_APPEND” نیز استفاده کنید که به معنی این است که محتوای جدید به انتهای فایل اضافه میشود.
به عنوان مثال، فرض کنید که میخواهید یک رشته را در یک فایل با نام “example.txt” ذخیره کنید. برای این منظور میتوانید از دستور زیر استفاده کنید:
$filename = “example.txt”;
$content = “این یک متن نمونه است.”;
file_put_contents($filename, $content);
در این مثال، تابع file_put_contents رشته “این یک متن نمونه است.” را در فایل با نام “example.txt” ذخیره میکند.