تابع ()file_put_contents
تابع ()file_put_contents
توابع کار با فایل ها در PHPتعریف و کاربرد
تابع ()file_put_contents یک رشته را درون یک فایل می نویسد.
این تابع به هنگام دسترسی به یک فایل، این قوانین را دنبال می کند:
- اگر که FILE_USE_INCLUDE_PATH ست شده باشد، مسیر اضافه شده را برای یک کپی از *filename* بررسی می کند.
- در صورتی که فایل مورد نظر وجود نداشته باشد، آن را ایجاد می کند.
- فایل مورد نظر را باز می کند.
- در صورتی که LOCK_EX ست شده باشد، فایل را قفل می کند.
- در صورتی که FILE_APPEND ست شده باشد، به پایان فایل حرکت می کند. در غیر این صورت محتوای فایل را پاک می کند.
- داده های مورد نظر را در فایل مورد نظر می نویسد.
- فایل را می بندد و تمام قفل ها را رها می کند.
این تابع در صورت موفقیت، تعداد کاراکترهای نوشته شده درون فایل مورد نظر را برمی گرداند و در صورت شکست FALSE برگردانده خواهد شد.
نحوه نوشتن
| پارامترها | توضیحات |
|---|---|
| file |
ضروری. فایلی که قرار است در آن نوشته شود را مشخص می کند. در صورتی که فایل مورد نظر وجود نداشته باشد این تابع یکی را ایجاد خواهد کرد. |
| data |
ضروری. داده هایی که قرار است در فایل مورد نظر نوشته شود. می تواند یک رشته، یک آرایه یا یک جریان داده(data stream) باشد. |
| mode |
اختیاری. مشخص می کند که چطور فایل مورد نظر باز شود و یا در آن نوشته شود. مقادیر امکان پذیر:
|
| context |
اختیاری. محتوای فایل بکار رفته را مشخص می کند. منظور از محتوا(context) مجموعه ای از گزینه ها است که می توانند رفتار یک جریان(stream) را تغییر دهند. |
نکات قابل توجه
نکته: برای اجتناب از حذف شدن محتوای متنی(context) فایل، از FILE_APPEND استفاده کنید.
مثال
echo file_put_contents("test.txt","Hello World. Testing!");
?>
خروجی کد بالا برابر است با:
- نوشته شده توسط احسان عباسی
- بازدید: 8089
