الدالة disk_total_space() في PHP
< PHP
(PHP 4 >= 4.1.0, PHP 5, PHP 7)
تعيد الدالة disk_total_space() المساحة الكلِّيَّة لنظام الملفات أو أحد الأقسام (disk partition).
الوصف
float disk_total_space ( string $directory )
تعيد هذه الدالة عدد البايتات الكلِّيَّة لنظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة directory التي تُمثِّل مسارًا للقسم أو حرفًا للقرص.
المعاملات
directory
مسار القسم أو حرف القرص المُراد معرفة مساحته الكلِّيَّة.
القيم المعادة
يُعاد عدد عشري (float) يمثِّل المساحة الكلِّيَّة بواحدة البايت، أو تُعاد القيمة FALSE عند فشل العمليَّة.
أمثلة
المثال 1: استعمال الدالة disk_total_space()
<?php
// “/” على الحجم المتاح بالبايت على المجلد الجذر $df سيحتوي المتغير
$ds = disk_total_space("/");
// أمَّا على ويندوز، فيُستعمل دليل القرص
$ds = disk_total_space("C:");
$ds = disk_total_space("D:");
?>
ملاحظات
لا تعمل هذه الدالة مع الملفات البعيدة إذ يجب أن يكون الملف قابلًا للوصول عبر نظام ملفات الخادم.
انظر أيضًا
- الدالة
disk_free_space(): إعادة المساحة المتاحة على نظام الملفات أو أحد الأقسام.