تقوم الدالة file_put_contents() بكتابة سلسلة نصية إلى ملف.
عندما تصل هذه الوظيفة إلى الملفات، فإنها تتبع القواعد التالية:
إذا تم تعيين FILE_USE_INCLUDE_PATH، فسيتم تحديد المسار المضمن لنسخة *اسم الملف*
إذا كان الملف غير موجود، سيتم إنشاء ملف
ملف مفتوح
إذا تم تعيين LOCK_EX، فسيتم قفل الملف
إذا تم تعيين FILE_APPEND، فسيتم نقله إلى نهاية الملف. وإلا سيتم مسح محتويات الملف
كتابة البيانات إلى الملف
إغلاق الملفات وفتح كافة الملفات
في حالة نجاحها، تقوم الدالة بإرجاع عدد الأحرف المكتوبة في الملف. إذا فشلت، يتم إرجاع False.
int file_put_contents ( سلسلة $filename ، بيانات $ مختلطة [، int $flags = 0 [، المورد $context ]])
| المعلمة | يصف |
|---|---|
| ملف | مطلوب. يحدد الملف الذي سيتم كتابة البيانات إليه. إذا كان الملف غير موجود، يتم إنشاء ملف جديد. |
| بيانات | مطلوب. يحدد البيانات المراد كتابتها في الملف. يمكن أن تكون سلسلة أو مصفوفة أو دفق بيانات. |
| وضع | خياري. يحدد كيفية فتح/كتابة الملف. القيم المحتملة: FILE_USE_INCLUDE_PATH FILE_APPEND LOCK_EX |
| سياق | خياري. يحدد البيئة لمقبض الملف. السياق عبارة عن مجموعة من الخيارات التي يمكنها تعديل سلوك الدفق. |
ملاحظة: استخدم FILE_APPEND لتجنب حذف المحتوى الموجود بالفعل في الملف.
مخرجات تنفيذ المثال أعلاه هي:
6
بعد ذلك نقوم بإلحاق المحتوى بالملف sites.txt:
بعد التنفيذ بنجاح، افتح ملف sites.txt، المحتوى هو:
com.CodertoGoogle