عرض مصدر PHP/disk total space

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

تعيد الدالة <code>disk_total_space()‎</code> المساحة الكلِّيَّة لنظام الملفات أو أحد الأقسام (disk partition).

== الوصف ==
<syntaxhighlight lang="php">
float disk_total_space ( string $directory )
</syntaxhighlight>تعيد هذه الدالة عدد البايتات الكلِّيَّة لنظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة <code>directory</code> التي تُمثِّل مسارًا للقسم أو حرفًا للقرص.

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

=== <code>directory</code> ===
مسار القسم أو حرف القرص المُراد معرفة مساحته الكلِّيَّة.

== القيم المعادة ==
يُعاد عدد عشري (float) يمثِّل المساحة الكلِّيَّة بواحدة البايت، أو تُعاد القيمة <code>FALSE</code> عند فشل العمليَّة.

== أمثلة ==
المثال 1: استعمال الدالة <code>disk_total_space()‎</code><syntaxhighlight lang="php">
<?php
// “/” على الحجم المتاح بالبايت على المجلد الجذر $df سيحتوي المتغير
$ds = disk_total_space("/");

// أمَّا على ويندوز، فيُستعمل دليل القرص
$ds = disk_total_space("C:");
$ds = disk_total_space("D:");
?>
</syntaxhighlight>

== ملاحظات ==
لا تعمل هذه الدالة مع الملفات البعيدة إذ يجب أن يكون الملف قابلًا للوصول عبر نظام ملفات الخادم.

== انظر أيضًا ==
* الدالة <code>[[PHP/disk free space|disk_free_space()‎]]</code>: إعادة المساحة المتاحة على نظام الملفات أو أحد الأقسام.

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