在PHP中修改文件夹名称可以通过内置的文件操作函数实现，核心操作逻辑简单且执行效率较高，不需要依赖额外的扩展库。
PHP修改文件夹名称的核心函数
PHP中修改文件夹名称最常用的是rename函数，这个函数不仅可以重命名文件，也可以重命名文件夹，函数的基本语法如下：
<?php /** * rename函数语法 * @param string $oldname 原文件夹路径 * @param string $newname 新文件夹路径 * @return bool 重命名成功返回true，失败返回false */ rename(string $oldname, string $newname): bool ?>
基本使用示例
假设服务器上存在一个名为old_dir的文件夹，需要将其重命名为new_dir，可以使用以下代码：
<?php
$old_dir = './old_dir';
$new_dir = './new_dir';
// 执行文件夹重命名操作
$result = rename($old_dir, $new_dir);
if ($result) {
echo '文件夹重命名成功';
} else {
echo '文件夹重命名失败';
}
?>
使用注意事项
- 原文件夹路径必须真实存在，否则会返回false，执行前可以先通过
is_dir函数判断文件夹是否存在。 - 执行操作的PHP进程需要有原文件夹的读取权限和新路径所在目录的写入权限，否则会因为权限不足导致操作失败。
- 如果新文件夹名称已经存在，rename函数会直接覆盖已有的文件夹，操作前建议先判断新名称是否已存在。
- 路径可以使用相对路径或者绝对路径，相对路径是相对于当前执行的PHP脚本所在目录。
带校验的完整示例
为了避免常见的错误，实际开发中可以在重命名前添加必要的校验逻辑：
<?php
$old_dir = './old_dir';
$new_dir = './new_dir';
// 校验原文件夹是否存在
if (!is_dir($old_dir)) {
echo '原文件夹不存在，无法执行重命名操作';
exit;
}
// 校验新文件夹是否已存在
if (is_dir($new_dir)) {
echo '新文件夹名称已存在，请更换名称后重试';
exit;
}
// 执行重命名操作
$result = rename($old_dir, $new_dir);
if ($result) {
echo '文件夹重命名成功，原名称：' . $old_dir . '，新名称：' . $new_dir;
} else {
echo '文件夹重命名失败，请检查文件权限或路径是否正确';
}
?>
常见问题排查
如果rename函数返回false，可以按照以下步骤排查问题：
- 检查原文件夹路径是否正确，是否存在拼写错误。
- 检查PHP进程对原文件夹和新路径所在目录的权限是否足够。
- 如果是在Windows服务器上操作，注意路径分隔符使用反斜杠时需要转义，或者使用正斜杠避免问题。
- 检查是否有其他进程正在占用原文件夹，导致无法执行重命名操作。