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

(PHP 4, PHP 5, PHP 7)

تعيد الدالة filesize()‎ حجم الملف.

الوصف

int filesize ( string $filename )

تعيد هذه الدالة حجم الملف filename.

المعاملات

filename

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

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

يُعاد حجم الملف filename بواحدة البايت أو القيمة FALSE مع توليد خطأ من المستوى E_WARNING عند حصول أي خطأ.

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

أمثلة

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

<?php

$filename = 'somefile.txt';
echo $filename . ': ' . filesize($filename) . ' bytes';

//somefile.txt: 1024 bytes

?>

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

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

ملاحظات

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

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

انظر أيضًا

• الدالة file_exists()‎: تتحقَّق من وجود الملف.

مصادر

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