PHP | disk_total_space()函数

简介

disk_total_space()是一个PHP内置函数，用于获取指定路径的总磁盘空间大小。它返回指定路径的总字节数，这可以用于监测磁盘空间的使用情况和限制。

语法

float disk_total_space ( string $directory )

参数

• $directory: 必需，要获取磁盘空间大小的目录路径。

返回值

• 如果成功，则返回指定路径的总字节数。
• 如果失败，则返回false。

示例

以下是一个使用disk_total_space()函数的示例：

$dir = '/var/www/html';

$bytes = disk_total_space($dir);

if ($bytes !== false) {
    $totalSpace = formatBytes($bytes);
    echo "Total disk space in $dir: $totalSpace";
} else {
    echo "Unable to retrieve disk space information.";
}

// 辅助函数，用于将字节数转换为人类可读的格式（如：KB、MB、GB）
function formatBytes($bytes, $precision = 2) {
    $units = array('B', 'KB', 'MB', 'GB', 'TB');

    $bytes = max($bytes, 0);
    $pow = floor(($bytes ? log($bytes) : 0) / log(1024));
    $pow = min($pow, count($units) - 1);

    $bytes /= (1 << (10 * $pow));

    return round($bytes, $precision) . ' ' . $units[$pow];
}

上述示例首先定义了要获取磁盘空间的目录路径为/var/www/html，然后调用disk_total_space($dir)函数获取该目录的总磁盘空间大小（字节数）。如果成功获取到磁盘空间大小，则使用辅助函数formatBytes($bytes)将字节数格式化为可读的单位（如：KB、MB、GB等），最后输出结果。如果获取失败，则显示错误消息。

注意事项

• disk_total_space()函数需要指定要获取磁盘空间大小的目录路径，而且必须保证PHP进程对该目录有足够的访问权限。
• 请确保目标目录存在，否则函数将返回false。
• 要获取整个磁盘的总空间大小，可以将根目录（如/）作为参数传递给disk_total_space()函数。