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

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

تعيد الدالة <code>disk_free_space()‎</code> المساحة المتوافرة (المتاحة) على نظام الملفات أو أحد الأقسام (disk partition).

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

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

=== <code>directory</code> ===
مسار القسم أو حرف القرص المراد معرفة مساحته المتاحة.

'''ملاحظة''': إن أعُطي اسم ملفٍ عوضًا عن المسار أو حرف القرص، فسيكون سلوك هذه الدالة غير معروف وسيختلف باختلاف نظام التشغيل وإصدار PHP المُستعمل.

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

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

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

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

== انظر أيضًا ==
* الدالة <code>[[PHP/disk-total-space|disk_total_space()‎]]</code>: إعادة المساحة الكلِّيَّة لنظام الملفات أو أحد الأقسام.

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