# disk_free_space

(PHP 4 >= 4.1.0, PHP 5, PHP 7)

disk_free_space — 返回目录中的可用空间

### 说明

disk_free_space ( string `$directory` ) : float

给出一个包含有一个目录的字符串，本函数将根据相应的文件系统或磁盘分区返回可用的字节数。

### 参数

`directory`

  文件系统目录或者磁盘分区。

  > Note:

  > 如果指定了文件名而不是文件目录，这个函数的行为将并不统一，会因操作系统和 PHP 版本而异。

### 返回值

以浮点返回可用的字节数， 或者在失败时返回 `FALSE`。

### 范例

Example #1 disk_free_space() 例子

    <?php
    // $df 包含根目录下可用的字节数
    $df = disk_free_space("/");

    //在 Windows 下:
    $df_c = disk_free_space("C:");
    $df_d = disk_free_space("D:");
    ?>

### 注释

> Note: 此函数不能作用于远程文件，被检查的文件必须是可通过服务器的文件系统访问的。

### 参见

- disk_total_space() - 返回一个目录的磁盘总大小