PHP 文件系统 diskfreespace() 函数



PHP 文件系统 diskfreespace() 函数用于查找磁盘或目录上的可用空间量。此函数是 disk_free_space() 函数的别名。

语法

以下是 PHP 文件系统 diskfreespace() 函数的语法:

float or integer diskfreespace(directory)

参数

使用 diskfreespace 函数所需的参数如下所示:

序号 参数及描述
1

directory(必需)

将要扫描的目录。

返回值

如果 diskfreespace() 函数成功,则返回可用字节数。如果发生错误,则返回 FALSE。

PHP 版本

diskfreespace() 函数最初作为 PHP 4 核心的一部分引入,并且与 PHP 5、PHP 7、PHP 8 兼容。

示例

这是一个基本示例,用于演示 PHP 文件系统 diskfreespace() 函数的使用。请查看以下代码示例:

<?php
   // This is the root directory.
   $directory = "/";  
   $freeSpace = diskfreespace($directory);

   echo "Free space available in the root directory: " . $freeSpace . " bytes";
?>

输出

这将生成以下结果:

Free space available in the root directory: 129400332288 bytes

示例

在以下代码中,我们将尝试使用 diskfreespace() 函数查找指定目录中的可用空间。请查看以下代码:

<?php
   // Display the free disk space on drive C:
   echo diskfreespace("C:");

   // Output a new line for formatting
   echo "\n";
   
   // Display the free disk space on drive E:
   echo diskfreespace("E:");
?>

输出

这将产生以下结果:

224159571968
209571344384

示例

此示例查找指定目录中的可用空间。因此,在使用 diskfreespace() 函数后,将检索并显示以字节为单位的可用空间。

<?php
   // Mention directory path here
   $directory = "/var/www";

   //Use diskfreespace() to get the free space of the above directory
   $freeSpace = diskfreespace($directory);

   // Echo or print the free space in bytes
   echo "Free space in /var/www: " . $freeSpace . " bytes";
?> 

输出

这将创建以下结果:

Free space in /var/www: 11686955416 bytes

示例

此示例将根目录中的可用空间从字节转换为兆字节,以提高可读性,并以 MB 为单位显示结果。

<?php
   // Mention directory path here
   $directory = "/";

   //Use diskfreespace() to get the free space of the above directory
   $freeSpace = diskfreespace($directory);

   // Convert in mega bytes (MB)
   $freeSpaceInMB = $freeSpace / (1024 * 1024);

   // Echo or print the free space in bytes
   echo "Free space in the root directory: " . $freeSpaceInMB . " MB";
?> 

输出

这将导致以下结果:

Free space in the root directory: 111455.765625 MB

示例

在此示例中,我们包含了错误处理。如果找不到目录,它会输出错误消息并检查 diskfreespace() 是否返回 FALSE,这表示发生了错误。

<?php
   // Mention directory path here
   $directory = "/nonexistent";

   //Use diskfreespace() to get the free space of the above directory
   $freeSpace = diskfreespace($directory);

   // Handle error here for nonexistent directory
   if ($freeSpace === FALSE) {
      echo "Error: Could not find the free space for the given directory.";
   } else {
      echo "Free space in ". $directory . ": " . $freeSpace . " bytes";
   }
?> 

输出

此 PHP 代码的结果为:

Error: Could not find the free space for the given directory.

注意

  • 此函数返回一个字节值。因此,您可以选择将其转换为千兆字节 (GB)、兆字节 (MB) 或千字节 (KB),以方便理解。
  • 如果给定的目录不存在或存在错误,则该函数可能无法返回预期结果。

总结

使用 PHP diskfreespace() 方法查找磁盘或目录上的可用空间量。您必须输入要检查的目录或磁盘的路径作为输入。

php_function_reference.htm
广告