Moves a file.

$source string Required

Path to the source file.

$destination string Required

Path to the destination file.

$overwrite bool Optional

Whether to overwrite the destination file if it exists.

Default: false

bool True on success, false on failure.

File: wp-admin/includes/class-wp-filesystem-direct.php. View all references

public function move( $source, $destination, $overwrite = false ) {
	if ( ! $overwrite && $this->exists( $destination ) ) {
		return false;
	}

	// Try using rename first. if that fails (for example, source is read only) try copy.
	if ( @rename( $source, $destination ) ) {
		return true;
	}

	if ( $this->copy( $source, $destination, $overwrite ) && $this->exists( $destination ) ) {
		$this->delete( $source );

		return true;
	} else {
		return false;
	}
}