PHP/filetype

(PHP 4, PHP 5, PHP 7)

تعيد الدالة filetype()‎ نوع الملف المحدَّد.

الوصف

string filetype ( string $filename )

تعيد هذه الدالة نوع الملف filename.

المعاملات

filename

مسار الملف الذي ستُجرى عليه العمليَّة.

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

يُعاد نوع الملف filename. القيم المتوقَّعة لنوع الملف هي إمَّا أنبوبة مسماة (FIFO وتدعى أحيانًا named pipe) أو ملف محرفي خاص (char) أو مجلد (dir) أو ملف كتلي خاص (block) أو وصلة رمزية (link) أو ملف عادي (file) أو مقبس (socket) أو نوع غير معروف (unknown).

تُعاد القيمة FALSE عند حصول أي خطأ. ستولِّد الدالة filetype()‎ الرسالة E_NOTICE إن فشل استدعاء الدالة stat()‎ أو كان نوع الملف غير معروف (unknown).

أمثلة

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

<?php

echo filetype('/etc/passwd');  // file
echo filetype('/etc/');        // dir

?>

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

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

ملاحظات

ستُخزَّن نتيجة هذه الدالة. راجع صفحة الدالة clearstatcache()‎ للمزيد من التفاصيل.

فائدة: يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).

انظر أيضًا

• الدالة is_dir()‎: تتحقَّق من أن نوع الملف أو المجلَّد المعطى هو مجلد.
• الدالة is_file()‎: تتحقَّق من أن نوع الملف المعطى هو ملف عادي.
• الدالة is_link()‎: تتحقَّق من أن نوع الملف المعطى هو وصلة رمزيَّة.
• الدالة file_exists()‎: تتحقَّق من وجود الملف أو المجلَّد.
• الدالة mime_content_type()‎: تعيد نوع المحتوى للملف بصيغة mime.
• الدالة pathinfo()‎: تعيد معلومات عن المسار المعطى للملف.
• الدالة stat()‎: تعيد معلومات عن ملف.

مصادر

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