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