(PECL eio >= 0.0.1dev)
eio_rename — 更改文件的名称或位置
$path
,$new_path
,$pri
= EIO_PRI_DEFAULT,$callback
= NULL,$data
= NULLeio_rename() 将文件重命名或移动到新位置。
path
源路径
new_path
目标路径
pri
请求优先级:EIO_PRI_DEFAULT
、EIO_PRI_MIN
、EIO_PRI_MAX
或 null
。如果传递 null
,pri
内部将设置为 EIO_PRI_DEFAULT
。
callback
callback
函数在请求完成时被调用。它应该匹配以下原型
void callback(mixed $data, int $result[, resource $req]);
data
是传递给请求的自定义数据。
result
请求特定的结果值;基本上,由相应系统调用返回的值。
req
是可选的请求资源,可以与 eio_get_last_error() 等函数一起使用
data
传递给 callback
的任意变量。
eio_rename() 在成功时返回请求资源,在失败时返回 false
。
示例 #1 eio_rename() 示例
<?php
$filename = dirname(__FILE__)."/eio-temp-file.dat";
touch($filename);
$new_filename = dirname(__FILE__)."/eio-temp-file-new.dat";
function my_rename_cb($data, $result) {
global $filename, $new_filename;
if ($result == 0 && !file_exists($filename) && file_exists($new_filename)) {
@unlink($new_filename);
echo "eio_rename_ok";
} else {
@unlink($filename);
}
}
eio_rename($filename, $new_filename, EIO_PRI_DEFAULT, "my_rename_cb", $filename);
eio_event_loop();
?>
上面的示例将输出类似于以下内容
eio_rename_ok