PHP file_put_contents() فنکشن

PHP Filesystem function

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

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

مانند استفاده از fopen()، fwrite() و fclose() به ترتیب است.

قانون‌نویسی

file_put_contents(file,data,mode,context)
پارامتر توضیح
file ضروری. فایلی که داده‌ها باید به آن نوشته شوند را مشخص می‌کند. اگر فایل وجود نداشت، یک فایل جدید ایجاد می‌شود.
data اختیاری. داده‌هایی که باید به فایل نوشته شوند را مشخص می‌کند. می‌تواند یک رشته، آرایه یا جریان باشد.
mode

اختیاری. روش باز کردن/نوشتن فایل را مشخص می‌کند. مقادیر ممکن:

  • FILE_USE_INCLUDE_PATH
  • FILE_APPEND
  • LOCK_EX
context

اختیاری. محیط دسترسی به فایل را مشخص می‌کند.

context یک مجموعه از تنظیمات است که می‌تواند رفتار جریان را تغییر دهد. اگر null استفاده شود، نادیده گرفته می‌شود.

توضیح

پارامتر data می‌تواند یک آرایه (اما نمی‌تواند آرایه چند بعدی باشد).

از PHP 5.1.0 به بعد،data پارامترها همچنین می‌توانند به عنوان منبع جریان مشخص شوند، داده‌های ذخیره شده در جریان به فایل مشخص شده نوشته می‌شوند، این استفاده مشابه با استفاده از فونکشن stream_copy_to_stream() است.

برای context پشتیبانی از پارامترها از PHP 5.0.0 اضافه شده است.

مقدار بازگشتی

این فونکشن تعداد بایت‌های نوشته شده به داخل فایل را بازمی‌گرداند.

توجه و نظرات

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

نکته:این فونکشن می‌تواند برای اشیاء دودویی به طور ایمن استفاده شود.

مثال

<?php
echo file_put_contents("test.txt","Hello World. Testing!");
?>

خروجی:

26

PHP Filesystem function