PHP file_put_contents() Function












❮ مرجع فایل سیستم PHP

مثال


نوشتن داده در فایل:




echo file_put_contents("test.txt", "Hello World. Testing!");

?>

خروجی کد بالا این خواهد بود:



21






تعریف و استفاده


file_put_contents() داده ها را در یک فایل می نویسد.


این تابع هنگام دسترسی به فایل از این قوانین پیروی می کند:



  1. اگر FILE_USE_INCLUDE_PATH تنظیم شده است، مسیر شامل را برای یک کپی از نام فایل
    2. بررسی کنید
  2. اگر فایل وجود ندارد ایجاد کنید

  3. فایل را باز کنید

  4. اگر LOCK_EX تنظیم شده است، فایل را قفل کنید

  5. اگر FILE_APPEND تنظیم شده است، به انتهای فایل بروید. در غیر این صورت، محتوای فایل را پاک کنید

  6. داده ها را در فایل بنویسید

  7. فایل را ببندید و قفل ها را آزاد کنید


توجه: برای جلوگیری از حذف محتوای موجود از FILE_APPEND استفاده کنید
فایل.



نحو



file_put_contents(نام فایل، داده، حالت، مطابق)

مقادیر پارامتر









ایجاد می کند



باشد









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

  • FILE_USE_INCLUDE_PATH - نام فایل را در فهرست شامل جستجو کنید

  • FILE_APPEND - اگر فایل از قبل وجود دارد، به جای آن، داده‌ها را به آن اضافه کنید
    رونویسی آن

  • LOCK_EX - در حین نوشتن روی فایل، یک قفل انحصاری روی آن قرار دهید
متن اختیاری. زمینه دسته فایل را مشخص می کند. Context مجموعه ای از گزینه ها است که می تواند رفتار یک جریان را تغییر دهد.











جزئیات فنی



















مقدار بازگشتی: تعداد بایت های نوشته شده در فایل در هنگام موفقیت، FALSE
در مورد شکست
نسخه PHP: 5.0+
ایمن باینری: بله
تغییر PHP: PHP
5.1 - اضافه شدن پشتیبانی از LOCK_EX و توانایی ارسال یک منبع جریان به
پارامتر داده


❮ مرجع فایل سیستم PHP