Moves a file or directory.

Description

After moving files or directories, OPcache will need to be invalidated.

If moving a directory fails, copy_dir() can be used for a recursive copy.

Use move_dir() for moving directories with OPcache invalidation and a fallback to copy_dir().

Parameters

$sourcestringrequired

Path to the source file.

$destinationstringrequired

Path to the destination file.

$overwritebooloptional

Whether to overwrite the destination file if it exists.

Default:false

Return

Source

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

	if ( $overwrite && $this->exists( $destination ) && ! $this->delete( $destination, true ) ) {
		// Can't overwrite if the destination couldn't be deleted.
		return false;
	}

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

	// Backward compatibility: Only fall back to `::copy()` for single files.
	if ( $this->is_file( $source ) && $this->copy( $source, $destination, $overwrite ) && $this->exists( $destination ) ) {
		$this->delete( $source );

		return true;
	} else {
		return false;
	}
}

View all references View on Trac View on GitHub

Changelog