تابع ()file_put_contents

PHP Filesystem Reference توابع کار با فایل ها در PHP

تعریف و کاربرد

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

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

اگر که FILE_USE_INCLUDE_PATH ست شده باشد، مسیر اضافه شده را برای یک کپی از *filename* بررسی می کند.
در صورتی که فایل مورد نظر وجود نداشته باشد، آن را ایجاد می کند.
فایل مورد نظر را باز می کند.
در صورتی که LOCK_EX ست شده باشد، فایل را قفل می کند.
در صورتی که FILE_APPEND ست شده باشد، به پایان فایل حرکت می کند. در غیر این صورت محتوای فایل را پاک می کند.
داده های مورد نظر را در فایل مورد نظر می نویسد.
فایل را می بندد و تمام قفل ها را رها می کند.

این تابع در صورت موفقیت، تعداد کاراکترهای نوشته شده درون فایل مورد نظر را برمی گرداند و در صورت شکست FALSE برگردانده خواهد شد.

نحوه نوشتن

file_put_contents(file,data,mode,context)

پارامترها	توضیحات
file	ضروری. فایلی که قرار است در آن نوشته شود را مشخص می کند. در صورتی که فایل مورد نظر وجود نداشته باشد این تابع یکی را ایجاد خواهد کرد.
data	ضروری. داده هایی که قرار است در فایل مورد نظر نوشته شود. می تواند یک رشته، یک آرایه یا یک جریان داده(data stream) باشد.
mode	اختیاری. مشخص می کند که چطور فایل مورد نظر باز شود و یا در آن نوشته شود. مقادیر امکان پذیر: FILE_USE_INCLUDE_PATH FILE_APPEND LOCK_EX
context	اختیاری. محتوای فایل بکار رفته را مشخص می کند. منظور از محتوا(context) مجموعه ای از گزینه ها است که می توانند رفتار یک جریان(stream) را تغییر دهند.

نکات قابل توجه

نکته: برای اجتناب از حذف شدن محتوای متنی(context) فایل، از FILE_APPEND استفاده کنید.

مثال

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

خروجی کد بالا برابر است با:

21

PHP Filesystem Reference توابع کار با فایل ها در PHP

: نوشته شده توسط احسان عباسی; بازدید: 7854

برای درج دیدگاه، ابتدا باید وارد بیاموز شوید.

تمامی محصولات و خدمات این وبسایت، حسب مورد دارای مجوزهای لازم از مراجع مربوطه می‌باشند و فعالیت‌های این سایت تابع قوانین و مقررات جمهوری اسلامی ایران است.

مجوز نشر دیجیتال از وزرات فرهنگ و ارشاد اسلامی