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
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;
}
}
Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.