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

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

تتحقَّق الدالة <code>is_uploaded_file()‎</code> إن كان الملف مرفوعًا باستعمال HTTP POST.

== الوصف ==
<syntaxhighlight lang="php">
bool is_uploaded_file ( string $filename )
</syntaxhighlight>تعيد هذه الدالة القيمة <code>TRUE</code> إن رُفع الملف الذي يُدعى <code>filename</code> بوساطة HTTP POST، وهذا الأمر مفيد لأنَّه يساعد على التأكُّد من عدم احتيال المستخدمين الخبيثين على السكربت لإجباره على العمل على ملفات لا يُفترض العمل عليها مثل الملف <code>‎/etc/passwd</code>.

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

تحتاج الدالة <code>is_uploaded_file()‎</code> من أجل العمل بطريقة صحيحة معاملًا مثل <code>‎$_FILES['userfile']['tmp_name']‎</code> إذ إنَّ اسم الملف المرفوع على جهاز العميل ‎<code>$_FILES['userfile']['name']‎</code> لا يعمل آنذاك.

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

=== <code>filename</code> ===
مسار الملف المراد التحقُّق منه.

== القيم المعادة ==
تُعاد القيمة <code>TRUE</code> عند نجاح العمليَّة، أو القيمة <code>FALSE</code> خلاف ذلك أو عند وجود خطأ.

== أمثلة ==
المثال 1: استعمال الدالة <code>is_uploaded_file()‎</code><syntaxhighlight lang="php">
<?php

if (is_uploaded_file($_FILES['userfile']['tmp_name'])) {
   echo "File ". $_FILES['userfile']['name'] ." uploaded successfully.\n";
   echo "Displaying contents\n";
   readfile($_FILES['userfile']['tmp_name']);
} else {
   echo "Possible file upload attack: ";
   echo "filename '". $_FILES['userfile']['tmp_name'] . "'.";
}

?>
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[PHP/move uploaded file|move_uploaded_file()‎]]</code>: تنقل ملفًا مرفوعًا إلى موقع جديد.
* ‎.$_FILE
* راجع أيضًا التحكم برفع الملفات للاطلاع على المزيد من الأمثلة البسيطة شائعة الاستعمال.

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