PHP 如何判断路径是不是目录？用 stat() 函数就能轻松识别

M66 2025-08-04

<span><span><span class="hljs-meta">&lt;?php</span></span><span>

</span><span><span class="hljs-comment">// 文章开头部分（无关内容）</span></span><span>

</span><span><span class="hljs-meta">?&gt;</span></span><span>

---

</span><span><span class="hljs-comment"># PHP 如何判断路径是不是目录？用 stat() 函数就能轻松识别</span></span><span>

在 PHP 中，判断一个路径是否为目录是一个非常常见的操作，尤其在文件系统操作中，程序需要判断路径的类型以执行不同的逻辑。PHP 提供了多种方式来完成这个任务，其中 `</span><span><span class="hljs-title function_ invoke__">stat</span></span><span>()` 函数是一个非常强大的工具，可以通过它来获取文件的详细信息，包括判断路径是否为目录。

</span><span><span class="hljs-comment">## 什么是 `stat()` 函数？</span></span><span>

`</span><span><span class="hljs-title function_ invoke__">stat</span></span><span>()` 函数用于获取关于指定文件或目录的信息。它返回一个数组，包含了文件或目录的各种元数据，包括文件大小、权限、修改时间等。最关键的是，`</span><span><span class="hljs-title function_ invoke__">stat</span></span><span>()` 还可以用来判断文件或路径的类型，这对于判断路径是否是目录十分有效。

</span><span><span class="hljs-comment">### `stat()` 函数的基本用法</span></span><span>

`</span><span><span class="hljs-title function_ invoke__">stat</span></span><span>()` 函数的语法如下：

```php
</span><span><span class="hljs-title function_ invoke__">stat</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$filename</span></span><span>): </span><span><span class="hljs-keyword">array</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>

$filename 是需要检测的文件或目录的路径。
如果路径存在并且读取成功，stat() 返回一个包含文件信息的数组。
如果路径不存在或发生错误，返回 false。

判断路径是否为目录

判断路径是否为目录的关键在于 stat() 函数返回的数组中的 dev 和 mode 字段。mode 字段表示文件的类型和权限。我们可以通过检查 mode 字段的值来判断路径是否是目录。

具体来说，stat() 返回的数组中的 mode 值可以与常量 S_IFDIR 进行位与操作，以确认文件是否是目录。

示例代码：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$path</span></span><span> = </span><span><span class="hljs-string">'/path/to/your/directory'</span></span><span>;

</span><span><span class="hljs-variable">$stat</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stat</span></span><span>(</span><span><span class="hljs-variable">$path</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$stat</span></span><span> !== </span><span><span class="hljs-literal">false</span></span><span> &amp;&amp; (</span><span><span class="hljs-variable">$stat</span></span><span>[</span><span><span class="hljs-string">'mode'</span></span><span>] &amp; </span><span><span class="hljs-number">0170000</span></span><span>) === </span><span><span class="hljs-number">0040000</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"<span class="hljs-subst">$path</span></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 class="hljs-subst">$path</span></span></span><span> 不是一个目录";
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

解释：

$stat['mode'] & 0170000 是对文件模式进行位与运算，获取文件的类型。
如果结果等于 0040000，则说明路径是一个目录。
stat() 返回的数组中还包含了其它信息，如文件大小、修改时间等，这些可以根据需要进一步使用。

使用 is_dir() 函数的对比

除了 stat()，PHP 还有一个专门用于判断路径是否是目录的函数 is_dir()，用法非常简单：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$path</span></span><span> = </span><span><span class="hljs-string">'/path/to/your/directory'</span></span><span>;

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">is_dir</span></span><span>(</span><span><span class="hljs-variable">$path</span></span><span>)) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"<span class="hljs-subst">$path</span></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 class="hljs-subst">$path</span></span></span><span> 不是一个目录";
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

is_dir() 函数在大多数情况下已经足够使用，它会返回一个布尔值：如果路径是目录，返回 true，否则返回 false。

不过，如果你需要更详细的文件信息，或者想要通过 stat() 获取更多的元数据，stat() 会是一个更好的选择。

总结

在 PHP 中，判断路径是否为目录有多种方法，其中使用 stat() 函数可以获得更多关于路径的信息，尤其是在需要进行更复杂的文件系统操作时。通过对 mode 字段的检查，我们可以轻松判断路径是否是目录。此外，is_dir() 函数虽然简单，但对于大多数应用场景已经足够使用。

选择合适的方法，可以帮助你更加高效地进行文件系统的操作。

<span><span><span class="hljs-meta">&lt;?php</span></span><span>

</span><span><span class="hljs-comment">// 文章尾部部分（无关内容）</span></span><span>

</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

stat
is_dir