PHP/copy

(PHP 4, PHP 5, PHP 7)

تنسخ الدالة copy()‎ ملفًا محدَّدًا وتضعه في الموقع المعطى.

الوصف

bool copy ( string $source , string $dest [, resource $context ] )

تُنشئ الدالة نسخةً من الملف source وتضعها في المسار dest المعطى. إن أردت نقل الملف وليس نسخه فاستعمل الدالة rename()‎.

المعاملات

source

مسار الملف المُراد نسخه.

dest

المسار الذي سيُنسخ الملف إليه. إن كان هذا المعامل هو رابط URL، فقد تفشل عملية النسخ إذا كان البروتوكول المُغلِّف للمسار لا يدعم عمليَّة استبدال الملف الموجود مسبقًا.

تحذير: إن كان الملف المراد نسخه موجود مسبقًا في الموقع dest، فسيُستبدل دون أيِّ تنبيه.

context

مصدر سياق سليم أُنشئ باستعمال الدالة stream_context_create()‎.

القيم المعادة

تُعاد القيمة TRUE عند نجاح العملية، والقيمة FALSE خلاف ذلك.

سجل التغييرات

الإصدار	الوصف
5.3.4	أضيفت تغييرات إلى المعامل context ليصبح ذو تأثير حقيقي، إذ كان يُتجاهل قبل ذلك.
5.3.0	إضافة دعم السياق (context).
4.3.0	أًصبح بالإمكان أن تكون قيمة المعامل source والمعامل dest رابطًا URL شرط تفعيل الخاصِّية "fopen wrappers". راجع صفحة الدالة fopen()‎ للمزيد من التفاصيل.

أمثلة

المثال 1: استعمال الدالة copy()‎

<?php
$file = 'example.txt';
$newfile = 'example.txt.bak';

if (!copy($file, $newfile)) {
    echo "failed to copy $file...\n";
}
?>

انظر أيضًا

• الدالة move_uploaded_file()‎: تنقل ملفًا مرفوعًا إلى موقع جديد.
• الدالة rename()‎: تعيد تسمية ملف أو مجلد.
• قسم التعامل مع رفع الملفات.

مصادر

• صفحة الدالة copy في توثيق PHP الرسمي.