如何用 PHP 的 disk_free_space 函数快速查看磁盘剩余空间？

gitbox 2025-09-30

在日常的 Web 开发中，管理服务器的存储空间是非常重要的一项工作。PHP 提供了一个非常方便的函数 disk_free_space()，它可以帮助我们快速查看服务器磁盘的剩余空间。本文将介绍如何使用该函数来获取磁盘剩余空间，并且如何结合实际项目需求进行应用。

什么是 disk_free_space() 函数？

disk_free_space() 是 PHP 的一个内置函数，它用于返回指定目录所在磁盘分区的可用空间（单位为字节）。如果你想要知道某个磁盘分区当前剩余多少可用空间，可以通过该函数非常方便地获取。

函数的基本语法如下：

<span><span><span class="hljs-title function_ invoke__">disk_free_space</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$directory</span></span><span>): </span><span><span class="hljs-keyword">int</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>

参数说明：

$directory：指定的目录路径。该目录可以是任意磁盘分区上的路径，通常我们会传递一个目录路径，如 / 或者 C:/。

返回值：

返回值是一个整数，表示磁盘的可用空间，单位是字节（bytes）。如果发生错误，函数返回 false。

示例：如何查看服务器磁盘剩余空间

假设我们想查看服务器的根目录 / 所在磁盘的剩余空间，可以使用如下代码：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$directory</span></span><span> = </span><span><span class="hljs-string">'/'</span></span><span>;
</span><span><span class="hljs-variable">$freeSpace</span></span><span> = </span><span><span class="hljs-title function_ invoke__">disk_free_space</span></span><span>(</span><span><span class="hljs-variable">$directory</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$freeSpace</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"无法获取磁盘剩余空间信息"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"剩余可用空间： "</span></span><span> . </span><span><span class="hljs-variable">$freeSpace</span></span><span> . </span><span><span class="hljs-string">" 字节"</span></span><span>;
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

运行上述代码时，如果根目录所在磁盘有可用空间，$freeSpace 会返回该磁盘的剩余空间（以字节为单位）。如果出现错误，函数会返回 false，并且我们可以根据这个判断是否成功获取到信息。

如何将字节转换为更易读的单位？

虽然 disk_free_space() 返回的是字节数，但是在实际应用中，我们通常需要将其转换为更易于理解的单位，例如 MB 或 GB。为了实现这个转换，我们可以编写一个简单的函数来实现：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">formatSize</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$size</span></span></span><span>) {
    </span><span><span class="hljs-variable">$units</span></span><span> = [</span><span><span class="hljs-string">'B'</span></span><span>, </span><span><span class="hljs-string">'KB'</span></span><span>, </span><span><span class="hljs-string">'MB'</span></span><span>, </span><span><span class="hljs-string">'GB'</span></span><span>, </span><span><span class="hljs-string">'TB'</span></span><span>];
    </span><span><span class="hljs-variable">$unitIndex</span></span><span> = </span><span><span class="hljs-number">0</span></span><span>;

    </span><span><span class="hljs-keyword">while</span></span><span> (</span><span><span class="hljs-variable">$size</span></span><span> &gt;= </span><span><span class="hljs-number">1024</span></span><span> &amp;&amp; </span><span><span class="hljs-variable">$unitIndex</span></span><span> &lt; </span><span><span class="hljs-title function_ invoke__">count</span></span><span>(</span><span><span class="hljs-variable">$units</span></span><span>) - </span><span><span class="hljs-number">1</span></span><span>) {
        </span><span><span class="hljs-variable">$size</span></span><span> /= </span><span><span class="hljs-number">1024</span></span><span>;
        </span><span><span class="hljs-variable">$unitIndex</span></span><span>++;
    }

    </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-title function_ invoke__">round</span></span><span>(</span><span><span class="hljs-variable">$size</span></span><span>, </span><span><span class="hljs-number">2</span></span><span>) . </span><span><span class="hljs-string">' '</span></span><span> . </span><span><span class="hljs-variable">$units</span></span><span>[</span><span><span class="hljs-variable">$unitIndex</span></span><span>];
}

</span><span><span class="hljs-variable">$directory</span></span><span> = </span><span><span class="hljs-string">'/'</span></span><span>;
</span><span><span class="hljs-variable">$freeSpace</span></span><span> = </span><span><span class="hljs-title function_ invoke__">disk_free_space</span></span><span>(</span><span><span class="hljs-variable">$directory</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$freeSpace</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"无法获取磁盘剩余空间信息"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"剩余可用空间： "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">formatSize</span></span><span>(</span><span><span class="hljs-variable">$freeSpace</span></span><span>);
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

通过 formatSize() 函数，我们能够将字节数转换为更加易于理解的单位，比如 KB、MB、GB 等。

如何处理磁盘剩余空间的监控？

在一些场景下，开发者可能需要定期监控磁盘剩余空间，以避免磁盘空间不足而导致服务中断。你可以通过设置定时任务来定期执行上述 PHP 脚本，或者在应用中加入磁盘空间监控的逻辑。

例如，你可以在 Web 应用的后台添加一个定时任务，定期检查磁盘空间，如果剩余空间低于某个阈值，就发送警告通知给管理员。

结语

通过 PHP 的 disk_free_space() 函数，我们能够轻松获取磁盘剩余空间，帮助我们及时发现存储空间不足的问题，避免系统崩溃或服务中断。在实际应用中，配合定时任务和空间阈值设置，可以为 Web 应用提供更加健壮的存储监控机制。

disk_free_space