PHP获取磁盘使用情况方法详解

本文全面介绍了在PHP中实时获取服务器磁盘使用情况的五种实用方法：从安全轻量的内置函数disk_total_space()和disk_free_space()，到跨平台系统命令调用（df/wmic），再到封装统一接口、使用proc_open()增强安全与超时控制，以及Linux下直接解析/proc虚拟文件系统的底层方案；无论您追求简洁可靠、多分区监控、代码复用性，还是高安全性与生产稳定性，都能从中找到适配不同环境与需求的最佳实践。

如果您需要在PHP脚本中实时获取服务器磁盘使用情况，则可通过系统函数直接调用底层磁盘信息接口。以下是几种可行的方法：

一、使用disk_total_space()和disk_free_space()函数

这两个内置函数分别返回指定路径所在分区的总字节数和剩余可用字节数，适用于大多数Linux、Windows及macOS环境，无需外部命令依赖，执行安全且轻量。

1、定义目标路径，例如根目录：$path = '/'；Windows下可设为 'C:/'。

2、调用disk_total_space($path)获取总空间字节数。

3、调用disk_free_space($path)获取剩余空间字节数。

4、通过差值计算已用空间：$used = disk_total_space($path) - disk_free_space($path)。

5、使用round($used / pow(1024, 3), 2)将字节数转换为GB并保留两位小数。

二、执行系统命令获取详细磁盘信息

通过exec()或shell_exec()调用df（Linux/macOS）或wmic（Windows）命令，可获得多分区、挂载点、使用率百分比等完整信息，适合需结构化展示或多磁盘监控的场景。

1、判断操作系统类型：if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') { ... } else { ... }。

2、Linux/macOS下执行：$output = shell_exec('df -h | grep "^/dev/"');。

3、Windows下执行：$output = shell_exec('wmic volume get name,capacity,freeSpace /format:csv');。

4、对$output按行分割，并使用preg_match或str_getcsv解析关键字段。

5、提取每行中的挂载点、总容量、可用空间及使用率数值。

三、使用disk_usage()封装函数统一处理

创建自定义函数disk_usage()，内部自动适配操作系统并返回标准化数组，包含total、free、used、percent、mount_point等键，提升代码复用性与可读性。

1、声明函数function disk_usage($path = null) { ... }。

2、若$path为空，Linux下默认取'/'，Windows下遍历C:、D:等驱动器。

3、优先尝试disk_total_space()方式获取基础数据。

4、若返回false（如路径不可达），则降级调用对应系统命令补全。

5、计算使用率：$percent = ($total > 0) ? round(($total - $free) / $total * 100, 1) : 0。

四、通过proc_open()安全执行df命令并限制超时

相较于shell_exec()，proc_open()支持设置执行超时、资源限制与错误流捕获，可防止因磁盘繁忙或权限问题导致脚本阻塞，增强生产环境稳定性。

1、构造命令字符串：$cmd = 'timeout 3s df -P / 2>/dev/null'（Linux）或'wmic volume where "Name=\'C:/\'" get Capacity,FreeSpace 2>nul'（Windows）。

2、定义描述符数组：$descriptorspec = [1 => ['pipe', 'w'], 2 => ['pipe', 'w']]。

3、调用$process = proc_open($cmd, $descriptorspec, $pipes)。

4、使用stream_get_contents($pipes[1])读取标准输出，fclose所有管道。

5、调用proc_close($process)释放进程资源，并校验返回码是否为0。

五、读取/proc/mounts与/proc/diskstats文件（仅Linux）

绕过命令行工具，直接解析内核暴露的虚拟文件系统数据，可避免shell注入风险，适用于高安全要求或禁用exec系列函数的受限环境。

1、检查文件是否存在且可读：if (is_readable('/proc/mounts') && is_readable('/proc/diskstats')) { ... }。

2、逐行读取/proc/mounts，提取所有ext4/xfs等本地文件系统挂载行。

3、对每个挂载点调用statvfs()获取f_blocks、f_bfree、f_bavail等字段。

4、根据f_frsize（文件系统块大小）计算实际字节数：$total = $statvfs['f_blocks'] * $statvfs['f_frsize']。

5、使用$f_bavail获取真实可用空间（排除root保留块），避免误判磁盘满状态。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~