rename() 可同時完成檔案移動與重命名。本文以批次將圖片 img_1.jpg 移至對應資料夾 img_1/ 並統一命名為 large.jpg 為例,展示實務用法。
<?php
// 取得目錄下所有檔名(Windows dir /b 指令)
$s = explode("\n", trim(`dir /b E:/11-2/caps`));
foreach ($s as $rs) {
$name = explode('.', $rs);
$folder = $name[0]; // img_1
mkdir("E:/11-2/caps/$folder"); // 建立資料夾
rename(
'E:/11-2/caps/' . $rs,
"E:/11-2/caps/$folder/large.jpg"
); // 移動並重命名
}
?>
rename(string $oldname, string $newname, resource $context = null): bool
oldname:原檔案/目錄路徑。newname:新路徑(可跨目錄,即移動)。context:Stream context(PHP 5.0+)。ftp://、ssh2.sftp://),但 oldname 與 newname 必須使用相同協議。rename('images', 'pictures'); // 目錄重命名
rename('html/cache.txt', 'html/rename.txt');
rename('html/cache2', 'html/cache3.txt'); // 檔案改名
rename('html', 'cache'); // 目錄改名
rename('file', 'html/files'); // 移動檔案到 html/files
if (rename($old, $new)) {
echo '更名/移動成功';
} else {
echo '失敗:' . error_get_last()['message'];
}