PHP 文件系统 disk_total_space() 函数

---

---

PHP 文件系统 **disk_total_space()** 函数可用于查找文件系统或磁盘分区（以字节为单位）的总大小。这对于跟踪磁盘使用情况、验证操作是否有足够的空间或允许访问磁盘数据非常有用。

给定包含目录的字符串，**disk_total_space()** 函数可以返回相应文件系统或磁盘分区上的总字节数。

语法

以下是 PHP 文件系统 **disk_total_space()** 函数的语法：

float disk_total_space ( string directory )

参数

使用 **disk_total_space()** 函数所需的参数如下：

返回值

它返回可用总磁盘空间的总字节数（浮点值），或者在失败时返回 FALSE。

PHP 版本

**disk_total_space()** 函数作为核心 PHP 4.1.0 的一部分提供，并且与 PHP 5、PHP 7、PHP 8 兼容。

示例

在下面的示例中，我们将看到通过传递磁盘名称作为参数来使用 PHP 文件系统 **disk_total_space()** 函数的基本用法，它将返回以字节为单位的可用总磁盘空间。

<?php
   echo disk_total_space("C:");
   echo "\n";
   echo disk_total_space("E:");
?>

输出

这将产生以下结果：

277320036352
209714147328

示例

使用下面的 PHP 代码，我们将尝试使用 **disk_total_space()** 函数获取指定文件夹的总磁盘空间。

<?php
   // assign directory or folder here
   $directory = '/home/user/Documents';

   // get the total disk space of the specified folder
   $total_space = disk_total_space($directory);

   //print the total disk space
   echo "Total disk space in directory $directory: " . $total_space . " bytes";
?> 

输出

这将生成以下输出：

Total disk space in directory /home/user/Documents: 245107195904 bytes

示例

现在，我们将创建一个程序来查找多个目录的总磁盘空间。为此，我们将创建一个目录数组，并使用 **disk_total_space()** 函数和 foreach 循环获取总磁盘空间。

<?php
   // assign directories or folders here
   $directories = ['/var/www/html', '/var/log'];

   // get the total disk space of each folder
   foreach ($directories as $dir) {
      $total_space = disk_total_space($dir);
      echo "Total disk space in directory $dir: " . $total_space . " bytes<br>";
   }
?> 

输出

这将导致以下结果：

Total disk space in directory /var/www/html: 245107195904 bytes
Total disk space in directory /var/log: 135506286782 bytes

示例

现在，我们将创建一个 PHP 程序来处理意外错误。例如，如果提到的目录不存在，我们应该如何处理这类错误，这在下面的代码中解释。

<?php
   // non existent directory
   $directory = '/nonexistent/directory';

   //find the total disk space
   $total_space = disk_total_space($directory);

   //Handle the error
   if ($total_space === false) {
      echo "Error to get total disk space for directory: $directory";
   } else {
      echo "The total disk space in directory $directory: " . $total_space . " bytes";
   }
?> 

输出

这段 PHP 代码的结果是：

Error to get total disk space for directory: /nonexistent/directory

注意

• 许多操作系统可以使用此方法，但目录路径格式（例如，基于 Unix 的系统上的“/”，Windows 上的“C:\”）可能会有所不同。
• 此方法不能应用于远程文件，因为要检查的文件需要通过服务器的文件系统访问。

总结

通过熟悉 **disk_total_space()** 函数，您可以轻松管理和监控 PHP 应用程序中的磁盘空间。