如何通過scandir 列出目錄中的符號鏈接以及其對應的文件？

gitbox 2025-09-09

在PHP 中， scandir函數可以列出指定目錄中的所有文件和子目錄。然而， scandir返回的只是一個簡單的文件和目錄列表，並沒有區分符號鏈接。為了列出目錄中的符號鏈接以及它們指向的目標文件，我們需要結合使用scandir和is_link 、 readlink函數來進行處理。

1. scandir基本用法

scandir函數返回指定目錄中的所有文件和子目錄，默認按字母順序排列。其基本用法如下：

 <span><span><span class="hljs-variable">$files</span></span><span> = </span><span><span class="hljs-title function_ invoke__">scandir</span></span><span>(</span><span><span class="hljs-variable">$directory</span></span><span>);
</span></span>

$directory參數是要掃描的目標目錄，返回值是一個數組，包含該目錄下所有的文件和子目錄。需要注意的是， scandir返回的列表包括了特殊的.和..項，分別表示當前目錄和父級目錄。

2. 過濾出符號鏈接

要判斷某個文件或目錄是否為符號鏈接，可以使用PHP 的is_link函數。它會檢查一個給定路徑是否是符號鏈接。

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">is_link</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> 是符號鏈接\n";
}
</span></span>

3. 獲取符號鏈接指向的目標

使用readlink函數可以獲取符號鏈接指向的實際文件路徑。如果給定的路徑是符號鏈接， readlink將返回符號鏈接的目標路徑；否則返回false 。

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">is_link</span></span><span>(</span><span><span class="hljs-variable">$path</span></span><span>)) {
    </span><span><span class="hljs-variable">$target</span></span><span> = </span><span><span class="hljs-title function_ invoke__">readlink</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-subst">$target</span></span><span>\n";
}
</span></span>

4. 完整代碼示例：列出目錄中的符號鏈接及其對應的文件

現在我們可以將以上代碼結合起來，列出指定目錄中的符號鏈接及其目標文件。

 <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-variable">$directory</span></span><span> = </span><span><span class="hljs-string">'/path/to/directory'</span></span><span>;

</span><span><span class="hljs-comment">// 使用 scandir 獲取目錄列表</span></span><span>
</span><span><span class="hljs-variable">$files</span></span><span> = </span><span><span class="hljs-title function_ invoke__">scandir</span></span><span>(</span><span><span class="hljs-variable">$directory</span></span><span>);

</span><span><span class="hljs-comment">// 遍歷目錄列表</span></span><span>
</span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$files</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$file</span></span><span>) {
    </span><span><span class="hljs-comment">// 排除 . 和 .. 項</span></span><span>
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$file</span></span><span> === </span><span><span class="hljs-string">'.'</span></span><span> || </span><span><span class="hljs-variable">$file</span></span><span> === </span><span><span class="hljs-string">'..'</span></span><span>) {
        </span><span><span class="hljs-keyword">continue</span></span><span>;
    }
    
    </span><span><span class="hljs-comment">// 拼接完整的文件路徑</span></span><span>
    </span><span><span class="hljs-variable">$filePath</span></span><span> = </span><span><span class="hljs-variable">$directory</span></span><span> . DIRECTORY_SEPARATOR . </span><span><span class="hljs-variable">$file</span></span><span>;
    
    </span><span><span class="hljs-comment">// 檢查文件是否為符號鏈接</span></span><span>
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">is_link</span></span><span>(</span><span><span class="hljs-variable">$filePath</span></span><span>)) {
        </span><span><span class="hljs-comment">// 获取符号链接方向的目标文件</span></span><span>
        </span><span><span class="hljs-variable">$target</span></span><span> = </span><span><span class="hljs-title function_ invoke__">readlink</span></span><span>(</span><span><span class="hljs-variable">$filePath</span></span><span>);
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"<span class="hljs-subst">$file</span></span></span><span> 是符號鏈接，方向 </span><span><span class="hljs-subst">$target</span></span><span>\n";
    }
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

5. 代碼解析

scandir($directory) : 獲取目錄中的所有文件和子目錄。
is_link($filePath) : 判斷當前文件是否為符號鏈接。
readlink($filePath) : 獲取符號鏈接指向的文件路徑。

6. 示例輸出

假設目錄/path/to/directory中有以下內容：

file1.txt （普通文件）
symlink1 （指向/path/to/target1.txt的符號鏈接）
symlink2 （指向/path/to/target2.txt的符號鏈接）

執行上述代碼後，輸出將是：

 <span><span>symlink1 是符號鏈接，方向 /</span><span><span class="hljs-type">path</span></span><span>/</span><span><span class="hljs-keyword">to</span></span><span>/target1.txt
symlink2 是符號鏈接，方向 /</span><span><span class="hljs-type">path</span></span><span>/</span><span><span class="hljs-keyword">to</span></span><span>/target2.txt
</span></span>

7. 小結

通過結合scandir和is_link 、 readlink函數，我們可以輕鬆地列出指定目錄中的符號鏈接及其對應的目標文件。這種方式能夠幫助我們更好地管理和分析文件系統中的符號鏈接，特別是在處理複雜的目錄結構時。