الدالة is_file()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تتحقَّق الدالة is_file()‎ إن كان الملف ملفًّا عاديًّا.

الوصف

bool is_file ( string $filename )

تتحقَّق هذه الدالة فيما إذا كان الملف filename ملفًّا عاديًّا.

المعاملات

filename

مسار الملف المراد التحقُّق منه.

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

تُعاد القيمة TRUE إن كان الملف filename موجودًا وهو ملفٌّ عاديٌّ، أو القيمة FALSE خلاف ذلك أو عند وجود خطأ.

ملاحظة: لمَّا كان نوع الأعداد الصحيحة في PHP هو ذات إشارة (signed) وأغلب المنصات تستعمل الأعداد الصحيحة بطول 32 بت، فقد تعيد بعض دوال نظام الملفات نتائج مخالفة للتوقعات عند استعمالها مع ملفات ذات حجم أكبر من 2 غيغابايت.

أمثلة

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

<?php
var_dump(is_file('a_file.txt')) . "\n";
var_dump(is_file('/usr/bin/')) . "\n";
?>

سيُظهر المثال السابق النتيجة التالية:

bool(true)
bool(false)

الأخطاء والاستثناءات

سيُصدر تحذير من المستوى E_WARNING عند فشل العمليَّة.

ملاحظات

• ستُخزَّن نتيجة هذه الدالة مؤقتًا. راجع الدالة clearstatcache()‎ للمزيد من التفاصيل.
• يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).

انظر أيضًا

• الدالة is_link()‎: تتحقَّق إن كان الملف وصلة رمزية.
• الدالة is_dir()‎: تتحقَّق إن كان المسار الممرَّر إلى الدالة هو لمجلد.

مصادر

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