eio_rename()

异步地将一个文件或目录重命名为另一个名称

首字母:E

函数名称:eio_rename()

函数描述:eio_rename() 函数用于异步地将一个文件或目录重命名为另一个名称。

适用版本:该函数在 PHP 5.4.0 及以上版本可用。

语法:eio_rename(string $from, string $to, int $priority, callable $callback, mixed $data = NULL) : resource

参数:

  • $from:要重命名的文件或目录的源路径。
  • $to:重命名后的文件或目录的目标路径。
  • $priority:任务优先级。大多数情况下,可以设置为 0。
  • $callback:完成任务后将调用的回调函数。
  • $data:回调函数的额外数据。默认值为 NULL。

返回值:

  • 如果调用成功,eio_rename() 函数将返回一个关联到任务的资源句柄。在回调函数中可以使用此句柄来访问任务状态。
  • 如果调用失败,eio_rename() 函数将返回 FALSE。

示例:


上述示例中,eio_rename() 函数用于异步地将文件 '/path/to/oldfile.txt' 重命名为 '/path/to/newfile.txt'。任务优先级设置为 0,回调函数根据任务结果输出相应的消息。

请注意,在使用 eio_rename() 函数时,需要确保扩展模块 "eio" 已启用。可以通过在 php.ini 文件中添加 "extension=eio.so" 启用该模块。

同首字母函数