Categories: PHP

PHP 各種列出目錄中所有檔案的做法教學與範例

介紹各種在 PHP 中列出目錄下所有檔案或子目錄的方法，並提供基本的範例程式碼。

`glob` 函數

PHP 的 glob 函數可以篩選出符合條件的檔案或目錄名稱。

例如列出目前目錄之下所有 *.txt 文字檔案：

# 列出所有 *.txt 文字檔案
foreach (glob("*.txt") as $filename) {
  echo "$filename 檔案大小：" . filesize($filename) . "\n";
}

file1.txt 檔案大小：35
file2.txt 檔案大小：159
file3.txt 檔案大小：70
file4.txt 檔案大小：31

也可以使用絕對路徑來列出指定目錄下的檔案：

# 列出指定路徑下的文字檔案
foreach (glob("/home/ubuntu/tmp/php/*.txt") as $filename) {
  echo "$filename 檔案大小：" . filesize($filename) . "\n";
}

/home/ubuntu/tmp/php/file1.txt 檔案大小：35
/home/ubuntu/tmp/php/file2.txt 檔案大小：159
/home/ubuntu/tmp/php/file3.txt 檔案大小：70
/home/ubuntu/tmp/php/file4.txt 檔案大小：31

使用中括號（[]）可以指定匹配的字元，例如若要列出目前目錄之下的 file2.txt、file3.txt 與 file4.txt 這三個檔案，就可以使用以下程式碼：

# 列出 file2.txt、file3.txt 與 file4.txt 文字檔案
foreach (glob("file[2-4].txt") as $filename) {
  echo "$filename 檔案大小：" . filesize($filename) . "\n";
}

file2.txt 檔案大小：159
file3.txt 檔案大小：70
file4.txt 檔案大小：31

`scandir` 函數

使用 scandir 函數列出目前目錄下所有檔案或子目錄：

# 列出指定路徑下的所有檔案
foreach (scandir(".") as $item) {
  if (is_dir($item)) {
    echo "目錄：$item\n";
  } else {
    echo "檔案：$item\n";
  }
}

目錄：.
目錄：..
檔案：file1.txt
檔案：file2.txt
檔案：file3.txt
檔案：file4.txt
目錄：folder1
目錄：folder2
檔案：script.php

亦可使用絕對路徑列出指定路徑下的所有檔案名稱或子目錄：

# 列出指定路徑下的所有檔案或子目錄
foreach (scandir("/home/ubuntu/tmp/php") as $item) {
  if (is_dir($item)) {
    echo "目錄：$item\n";
  } else {
    echo "檔案：$item\n";
  }
}

目錄：.
目錄：..
檔案：file1.txt
檔案：file2.txt
檔案：file3.txt
檔案：file4.txt
目錄：folder1
目錄：folder2
檔案：script.php

通常我們都會將 . 與 .. 這兩個特殊目錄去除：

# 指定目錄路徑
$directory = '/home/ubuntu/tmp/php';

# 列出所有檔案或目錄，去除「.」與「..」目錄
$items = array_diff(scandir($directory), array('..', '.'))

# 輸出檔案或目錄
foreach ($items as $item) {
  if (is_dir($item)) {
    echo "目錄：$item\n";
  } else {
    echo "檔案：$item\n";
  }
}

檔案：file1.txt
檔案：file2.txt
檔案：file3.txt
檔案：file4.txt
目錄：folder1
目錄：folder2
檔案：script.php

更近一步可以使用 preg_grep 這類的函數，以正規表示法根據檔案名稱來篩選需要的項目：

# 指定目錄路徑
$directory = '/home/ubuntu/tmp/php';

# 以正規表示法篩選出 *.txt 的檔案
$txtItems = preg_grep("/\.txt$/", scandir($directory));

# 輸出 *.txt 檔案
foreach ($txtItems as $item) {
  echo "$item\n";
}

file1.txt
file2.txt
file3.txt
file4.txt

`readdir` 函數

readdir 函數也可以用來取得指定目錄之下的所有檔案與子目錄名稱：

# 開啟目錄
if ($handle = opendir('.')) {
  # 取得目錄內的檔案或子目錄
  while (false !== ($entry = readdir($handle))) {
    # 去除「.」與「..」目錄
    if ($entry != '.' && $entry != '..') {
      if (is_dir($entry)) {
        echo "目錄：$entry\n";
      } else {
        echo "檔案：$entry\n";
      }
    }
  }
  closedir($handle);
}

檔案：file4.txt
檔案：file2.txt
目錄：folder1
檔案：file3.txt
檔案：script.php
檔案：file1.txt
目錄：folder2

搭配 preg_match 以正規表示法根據檔案名稱篩選出文字檔案：

# 開啟目錄
if ($handle = opendir('.')) {
  # 取得目錄內的檔案或子目錄
  while (false !== ($entry = readdir($handle))) {
    # 篩選出 *.txt 檔案
    if (preg_match("/.txt$/", $entry)) {
      echo "$entry\n";
    }
  }
  closedir($handle);
}