萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 批量修改檔案名稱實戰:遞迴遍歷目錄與隨機重命名

需求場景

需要遍歷指定目錄及所有子目錄,將所有檔案(不含資料夾)重新命名為隨機數字,保留副檔名。

核心函數說明

函數用途
is_dir()判斷路徑是否為目錄
opendir() / readdir()開啟目錄並逐一讀取項目
pathinfo()解析路徑取得 dirname、basename、extension
rename()重命名檔案/目錄
rand()產生隨機數

完整程式碼

<?php
/**
 * 遞迴遍歷目錄並重命名所有檔案
 * @param string $dirname 目標目錄路徑
 */
function fRename($dirname) {
    // 1. 驗證目錄合法性
    if (!is_dir($dirname)) {
        echo "{$dirname} 不是一個有效的目錄!";
        exit();
    }

    $handle = opendir($dirname);
    // 2. 逐一讀取目錄項目
    while (($fn = readdir($handle)) !== false) {
        // 3. 跳過 . 和 ..
        if ($fn !== '.' && $fn !== '..') {
            $curDir = $dirname . '/' . $fn;
            
            // 4. 若是目錄 → 遞迴處理
            if (is_dir($curDir)) {
                fRename($curDir);
            } 
            // 5. 若是檔案 → 隨機重命名
            else {
                $path = pathinfo($curDir);
                // 隨機數 0-100 + 原副檔名
                $newname = $path['dirname'] . '/' . rand(0, 100) . '.' . $path['extension'];
                rename($curDir, $newname);
                echo $curDir . ' --- ' . $newname . "<br/>";
            }
        }
    }
    closedir($handle);
}

// 執行:傳入目標目錄名稱
fRename('pl');
?>

關鍵細節解析

1. 全等比較 !== false

readdir() 可能回傳 0、"" 等 falsy 值,必須用 全等(=== / !==) 判斷,否則檔名為 "0" 時會誤判為結束。

2. pathinfo() 回傳結構

$path = pathinfo('/path/to/file.txt');
/*
Array(
    [dirname] => /path/to
    [basename] => file.txt
    [extension] => txt
    [filename] => file      // PHP 5.2+
)
*/

3. 遞迴終止條件

  • 自然終止:目錄讀完
  • 安全終止:is_dir() 防呆

4. 實務改進建議

  • 隨機數易衝突 → 改用 uniqid()、microtime(true)、UUID
  • 需保留原檔名資訊 → 結合時間戳、雜湊值
  • 大量檔案 → 考慮 RecursiveDirectoryIterator (SPL) 更優雅
  • 錯誤處理:rename() 失敗時記錄日誌、拋出例外

進階版:使用 SPL 迭代器

function renameFilesRecursive($dir) {
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST
    );
    
    foreach ($iterator as $file) {
        if ($file->isFile()) {
            $newName = $file->getPath() . '/' . uniqid() . '.' . $file->getExtension();
            rename($file->getPathname(), $newName);
            echo "{$file->getPathname()} → {$newName}<br>";
        }
    }
}

安全性警示

⚠️ 實際部署時務必加入:路徑白名單驗證、權限檢查、操作日誌、乾跑模式、備份機制。切勿直接對使用者輸入路徑執行刪改操作!

copyright © 萬盛學電腦網 all rights reserved