# move_dir()

URL: https://chugunov.pro/api-wordpress/functions/move_dir/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 6.2.0.

## Сигнатура

```php
move_dir( string $from, string $to, bool $overwrite = false ): true|WP_Error
```

## Описание

При успехе рекурсивно сбрасывает OPcache.
Если переименование не удалось, использует запасной вариант copy_dir() .
Предполагается, что WP_Filesystem() уже был вызван и настроен.
Эта функция не предназначена для слияния каталогов, вместо неё следует использовать copy_dir().

## Параметры

- `$from` `string` — обязательный. Исходный каталог.
- `$to` `string` — обязательный. Каталог назначения.
- `$overwrite` `bool` — необязательный, по умолчанию `false`. Перезаписывать ли каталог назначения, если он уже существует.

## Возвращаемое значение

`true|WP_Error` — WP_Error

## Исходный код

Файл: `wp-admin/includes/file.php:2095`

```php
function move_dir( $from, $to, $overwrite = false ) {
	global $wp_filesystem;

	if ( trailingslashit( strtolower( $from ) ) === trailingslashit( strtolower( $to ) ) ) {
		return new WP_Error( 'source_destination_same_move_dir', __( 'The source and destination are the same.' ) );
	}

	if ( $wp_filesystem->exists( $to ) ) {
		if ( ! $overwrite ) {
			return new WP_Error( 'destination_already_exists_move_dir', __( 'The destination folder already exists.' ), $to );
		} elseif ( ! $wp_filesystem->delete( $to, true ) ) {
			// Can't overwrite if the destination couldn't be deleted.
			return new WP_Error( 'destination_not_deleted_move_dir', __( 'The destination directory already exists and could not be removed.' ) );
		}
	}

	if ( $wp_filesystem->move( $from, $to ) ) {
		/*
		 * When using an environment with shared folders,
		 * there is a delay in updating the filesystem's cache.
		 *
		 * This is a known issue in environments with a VirtualBox provider.
		 *
		 * A 200ms delay gives time for the filesystem to update its cache,
		 * prevents "Operation not permitted", and "No such file or directory" warnings.
		 *
		 * This delay is used in other projects, including Composer.
		 * @link https://github.com/composer/composer/blob/2.5.1/src/Composer/Util/Platform.php#L228-L233
		 */
		usleep( 200000 );
		wp_opcache_invalidate_directory( $to );

		return true;
	}

	// Fall back to a recursive copy.
	if ( ! $wp_filesystem->is_dir( $to ) ) {
		if ( ! $wp_filesystem->mkdir( $to, FS_CHMOD_DIR ) ) {
			return new WP_Error( 'mkdir_failed_move_dir', __( 'Could not create directory.' ), $to );
		}
	}

	$result = copy_dir( $from, $to, array( basename( $to ) ) );

	// Clear the source directory.
	if ( true === $result ) {
		$wp_filesystem->delete( $from, true );
	}

	return $result;
}
```

## История изменений

- 6.2.0 — Introduced.

## Связанные

Использует: [`wp_opcache_invalidate_directory`](https://chugunov.pro/api-wordpress/functions/wp_opcache_invalidate_directory/), [`copy_dir`](https://chugunov.pro/api-wordpress/functions/copy_dir/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`trailingslashit`](https://chugunov.pro/api-wordpress/functions/trailingslashit/), `WP_Error::__construct`.
Используется в: `WP_Upgrader::move_to_temp_backup_dir`, `WP_Upgrader::restore_temp_backup`, `WP_Upgrader::install_package`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/move_dir/