عرض مصدر PHP/move uploaded file

<noinclude>{{DISPLAYTITLE:الدالة <code>move_uploaded_file()</code>‎ في PHP}}</noinclude>
(PHP 4 >= 4.0.3, PHP 5, PHP 7)

تنقل الدالة <code>move_uploaded_file()‎</code> ملفًا مرفوعًا إلى موقع جديد.

== الوصف ==
<syntaxhighlight lang="php">
bool move_uploaded_file ( string $filename , string $destination )
</syntaxhighlight>تتحقَّق هذه الدالة إن كان الملف <code>filename</code> مرفوعًا بطريقة صحيحة (أي أنَّه رُفِع باستعمال الطريقة POST) ثمَّ تنقله إلى الموقع <code>destination</code> المعطى.

التحقُّق الذي تجريه الدالة له أهمية كبيرة إذ يمكن مصادفةً أن تؤدي أي عمليَّة تُجرى على الملفات المرفوعة إلى إظهار محتواها للمستخدم أو المستخدمين الآخرين الموجودين على النظام ذاته.

== المعاملات ==

=== <code>filename</code> ===
اسم الملف المرفوع المراد نقله.

=== <code>destination</code> ===
الموقع المراد نقل الملف إليه.

== القيم المعادة ==
تُعاد القيمة <code>TRUE</code> عند نجاح العمليَّة.

إن كان المعامل <code>filename</code> ملفًا مرفوعًا بطريقة غير صحيحة، فلن يُتخذ أي إجراء وستُعاد القيمة <code>FALSE</code>.

إن كان العامل <code>filename</code> ملفًا مرفوعًا بطريقة صحيحة ولكن لا يمكن نقله لعدَّة أسباب، فلن يُتخذ أي إجراء وستُعاد القيمة <code>FALSE</code> بالإضافة إلى إصدار تنبيه.

== أمثلة ==
المثال 1: رفع ملفات متعدِّدة<syntaxhighlight lang="php">
<?php
$uploads_dir = '/uploads';
foreach ($_FILES["pictures"]["error"] as $key => $error) {
    if ($error == UPLOAD_ERR_OK) {
        $tmp_name = $_FILES["pictures"]["tmp_name"][$key];
        // (filesystem traversal attacks) هجمات تجاوز نظام الملفات basename() ربما تمنع الدالة
        // إجراء المزيد من عمليات التحقُّق من صحة وسلامة اسم الملف قد يكون كافيًا
        $name = basename($_FILES["pictures"]["name"][$key]);
        move_uploaded_file($tmp_name, "$uploads_dir/$name");
    }
}
?>
</syntaxhighlight>

== ملاحظات ==
تأخذ الدالة <code>move_uploaded_file()‎</code> الوضع الآمن (safe_mode) والمتغير <code>open_basedir</code> بالحسبان. على أيِّ حال، ستُطبَّق القيود على المسار <code>destination</code> فقط عند السماح بنقل الملفات المرفوعة إليه إذ قد يتعارض اسم الملف <code>filename</code> مع بعض القيود تلك.

تتأكَّد الدالة <code>move_uploaded_file()‎</code> من سلامة تنفيذ العمليَّة عبر السماح للملفات المرفوعة بوساطة PHP فقط بالانتقال إلى الموقع المعطى.

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

== انظر أيضًا ==
* الدالة <code>[[PHP/is uploaded file|is_uploaded_file()‎]]</code>: تتأكد من عمليَّة رفع الملف باستعمال HTTP POST.
* الدالة <code>[[PHP/rename|rename()‎]]</code>: تعيد تسمية ملف أو مجلَّد ما.
* التحكم برفع الملفات للاطلاع على المزيد من الأمثلة البسيطة شائعة الاستعمال.

== مصادر ==
* [http://php.net/manual/en/function.move-uploaded-file.php صفحة الدالة move_uploaded_file في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Filesystem]]