rename()

1. 定义

对指定文件或目录进行重命名。由于重命名的参数包含路径,所以也可以使用该函数进行文件的移动。 成功时返回TRUE,失败则返回FALSE。

2. 语法

rename ( string $oldname , string $newname [, resource $context ] ) : bool

3. 参数说明

参数 可选性 数据类型 描述
$oldname 必需 字符串 要重命名的文件或目录路径(包括文件名)
$newname 必需 字符串 新的文件或目录路径(包括文件名)
$context 可选 资源类型 资源流上下文

4. 示例

<?php

// rename()
// 对指定文件或目录进行重命名

file_put_contents('test.txt', '');

$res = rename(__DIR__.'/test.txt', 'test_changed.txt');
if($res) {
    echo '重命名文件成功!',"\n";
} else {
    echo '重命名失败!',"\n";
}
// 输出:重命名文件成功!

5. 延展阅读