English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

دليل درس PHP الأساسي

دليل درس PHP المتقدم

PHP & MySQL

دليل مرجع PHP

استخدام وظيفة PHP file_put_contents() ومثال

دليل وثائق نظام الملفات PHP

يمكن للدالة file_put_contents() كتابة السلسلة في الملف.

القواعد

int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]])

عندما يزور هذا الدالة الملف، تتبع القواعد التالية:

  1. إذا تم تعيين FILE_USE_INCLUDE_PATH، فإنه سيقوم بالتحقق من نسخة *filename* من المسارات المدمجة

  2. إذا لم يكن الملف موجودًا، سيتم إنشاء ملف

  3. فتح الملف

  4. إذا تم تعيين LOCK_EX، فإنه سيقوم بلocking الملف

  5. إذا تم تعيين FILE_APPEND، فإنه سيقوم بالانتقال إلى نهاية الملف. وإلا، سيتم حذف محتوى الملف

  6. كتابة البيانات في الملف

  7. إغلاق الملف وإزالة قفل جميع الملفات

إذا كانت النتيجة ناجحة، يمكن أن يعود هذا الدالة عدد الأحرف التي تم كتابتها في الملف. إذا كانت الفشل، يمكن أن يعود إلى false.

المستوى

المستوىالوصف
fileمطلوب. تحديد الملف الذي سيتم كتابة البيانات فيه. إذا لم يكن الملف موجودًا، سيتم إنشاء ملف جديد.
dataمطلوب. تحديد البيانات التي سيتم كتابتها في الملف. يمكن أن يكون هذا النوع سلسلة أو مصفوفة أو تدفق بيانات.
modeاختياري. تحديد كيفية فتح/كتابة الملف. القيم الممكنة:
  • FILE_USE_INCLUDE_PATH

  • FILE_APPEND

  • LOCK_EX

البيئةاختياري. تحديد بيئة ملف الملف. البيئة هي مجموعة من الخيارات التي يمكن تعديل سلوك السلسلة.

مثال1

كتابة المحتوى إلى ملف sample.txt

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

نتائج الإخراج

11

مثال2

استخدام FILE_APPEND لإضافة المحتوى، لتجنب حذف المحتوى الموجود في الملف.

<?php
   $file = "sample.txt";
   // المستخدم الجديد الذي سيتم إضافته إلى الملف
   $test = "  w3codebox ";
   // استخدم علامة FILE_APPEND لضبط المحتوى في نهاية الملف
   // وكذلك علامة LOCK_EX لمنع أي شخص آخر من كتابة الملف في نفس الوقت
   file_put_contents($file, $test, FILE_APPEND | LOCK_EX);
   echo "المحتوى تم إضافته بنجاح إلى الملف.";
?>

نتائج الإخراج

المحتوى تم إضافته بنجاح إلى الملف.

دليل وثائق نظام الملفات PHP