WordPress 6.2 支持移动整个文件目录

move_dir() wordpress函数介绍

move_dir()是一个WordPress函数，用于将WordPress文件系统中的文件夹从一个位置移动到另一个位置。

函数语法：

“`php
move_dir( $from, $to )
“`

参数说明：

– `$from`：要移动的目录路径。
– `$to`：目标路径，也就是将目录移动到哪个位置。

函数返回值：

函数返回移动成功的目录路径。如果移动失败，则返回一个WP_Error对象。

使用注意事项：

– 在调用该函数之前，需要先在代码中添加文件系统API。
– 应在调用该函数之后使用filesystem API的函数，以便获得反馈并确保移动操作成功。
– 移动操作将覆盖目标路径中的任何文件夹，因此请谨慎操作。

这个哪个版本开始使用的

`move_dir()`函数是从WordPress版本2.6中引入的，并一直存在于当前最新的版本（截至2021年8月）。因此，如果您要使用该函数，请确保您的WordPress版本是2.6或更高版本。

move_dir() 使用案例

下面是一个使用`move_dir()`函数将WordPress中的文件夹从一个位置移动到另一个位置的例子：

“`php
/**
* 将插件的默认数据目录移动到指定目录中
*
* @param string $plugin_data_dir 默认数据目录路径
* @param string $new_data_dir 新的数据目录路径
*
* @return WP_Error|string 成功时返回新的数据目录路径，失败时返回WP_Error对象
*/
function move_plugin_data_dir( $plugin_data_dir, $new_data_dir ) {

// 检查文件系统API是否可用
if ( ! function_exists( ‘WP_Filesystem’ ) ) {
require_once ABSPATH . ‘wp-admin/includes/file.php’;
}

// 初始化文件系统API
WP_Filesystem();

// 检查目标目录是否存在，如果不存在，则创建目录
if ( ! file_exists( $new_data_dir ) ) {
$result = mkdir( $new_data_dir, 0755, true );
if ( ! $result ) {
return new WP_Error( ‘dir_create_error’, ‘无法创建目录：’ . $new_data_dir );
}
}

// 移动目录
$result = move_dir( $plugin_data_dir, $new_data_dir );
if ( is_wp_error( $result ) ) {
return $result;
}

return $new_data_dir;
}
“`

使用示例：

“`php
$plugin_dir = WP_PLUGIN_DIR . ‘/my-plugin’;
$default_data_dir = $plugin_dir . ‘/data’;
$new_data_dir = WP_CONTENT_DIR . ‘/plugins-data/my-plugin-data’;

$result = move_plugin_data_dir( $default_data_dir, $new_data_dir );
if ( is_wp_error( $result ) ) {
echo $result->get_error_message();
} else {
echo ‘插件数据目录已移动到：’ . $result;
}
“`

该示例会将默认数据目录`my-plugin/data`移动到指定的目录`wp-content/plugins-data/my-plugin-data`中。如果移动成功，则会在前台显示一个成功的消息。如果移动失败，则会显示一个错误消息。