php 文件移动和重命名的函数

封面图 • 2025-10-09 • PHP

在 PHP 中，移动和重命名文件可以使用内置的函数 `rename()`。这个函数既可以用来**重命名文件**，也可以用来**移动文件**（即改变文件的路径）。

---

### ✅ 1. `rename()` 函数

#### 语法：
```php
bool rename(string $from, string $to, ?callable $on_error = null)
```

- `$from`：原文件路径。
- `$to`：目标路径（可以是新文件名或新路径）。
- `$on_error`：可选参数，用于处理错误（PHP 8.1+ 支持）。

---

### 📌 示例：重命名文件

```php
<?php
$old_name = 'oldfile.txt';
$new_name = 'newfile.txt';

if (rename($old_name, $new_name)) {
    echo "文件重命名成功！";
} else {
    echo "文件重命名失败！";
}
?>
```

---

### 📌 示例：移动文件

```php
<?php
$source = 'uploads/file.txt';
$destination = 'backup/file.txt';

if (rename($source, $destination)) {
    echo "文件移动成功！";
} else {
    echo "文件移动失败！";
}
?>
```

---

### ⚠️ 注意事项：

- 如果目标路径已经存在同名文件，`rename()` 会**覆盖**它。
- 要确保 PHP 有权限对源文件和目标路径进行操作。
- 可以使用 `is_file()` 或 `file_exists()` 检查文件是否存在。

---

### ✅ 其他相关函数：

| 函数 | 说明 |
|------|------|
| `copy()` | 复制文件（不删除原文件） |
| `unlink()` | 删除文件 |
| `is_file()` | 检查是否为文件 |
| `file_exists()` | 检查文件是否存在 |

---

### 🧠 小技巧：同时重命名和移动文件

你可以将 `rename()` 用于同时重命名和移动文件，例如：

```php
rename('old/path/file.txt', 'new/path/newfile.txt');
```

这会把 `file.txt` 移动到 `new/path/` 并重命名为 `newfile.txt`。

---

如果你需要更复杂的文件操作（如批量移动、复制、删除等），可以结合 `scandir()` 或 `glob()` 来遍历目录。

需要我帮你写一个批量移动文件的例子吗？