--- /dev/null
+<?php
+
+namespace Drupal\Tests\file\Kernel;
+
+use Drupal\file\Entity\File;
+
+/**
+ * Tests the file move function.
+ *
+ * @group file
+ */
+class MoveTest extends FileManagedUnitTestBase {
+ /**
+ * Move a normal file.
+ */
+ public function testNormal() {
+ $contents = $this->randomMachineName(10);
+ $source = $this->createFile(NULL, $contents);
+ $desired_filepath = 'public://' . $this->randomMachineName();
+
+ // Clone the object so we don't have to worry about the function changing
+ // our reference copy.
+ $result = file_move(clone $source, $desired_filepath, FILE_EXISTS_ERROR);
+
+ // Check the return status and that the contents changed.
+ $this->assertTrue($result, 'File moved successfully.');
+ $this->assertFalse(file_exists($source->getFileUri()));
+ $this->assertEqual($contents, file_get_contents($result->getFileUri()), 'Contents of file correctly written.');
+
+ // Check that the correct hooks were called.
+ $this->assertFileHooksCalled(['move', 'load', 'update']);
+
+ // Make sure we got the same file back.
+ $this->assertEqual($source->id(), $result->id(), format_string("Source file id's' %fid is unchanged after move.", ['%fid' => $source->id()]));
+
+ // Reload the file from the database and check that the changes were
+ // actually saved.
+ $loaded_file = File::load($result->id());
+ $this->assertTrue($loaded_file, 'File can be loaded from the database.');
+ $this->assertFileUnchanged($result, $loaded_file);
+ }
+
+ /**
+ * Test renaming when moving onto a file that already exists.
+ */
+ public function testExistingRename() {
+ // Setup a file to overwrite.
+ $contents = $this->randomMachineName(10);
+ $source = $this->createFile(NULL, $contents);
+ $target = $this->createFile();
+ $this->assertDifferentFile($source, $target);
+
+ // Clone the object so we don't have to worry about the function changing
+ // our reference copy.
+ $result = file_move(clone $source, $target->getFileUri(), FILE_EXISTS_RENAME);
+
+ // Check the return status and that the contents changed.
+ $this->assertTrue($result, 'File moved successfully.');
+ $this->assertFalse(file_exists($source->getFileUri()));
+ $this->assertEqual($contents, file_get_contents($result->getFileUri()), 'Contents of file correctly written.');
+
+ // Check that the correct hooks were called.
+ $this->assertFileHooksCalled(['move', 'load', 'update']);
+
+ // Compare the returned value to what made it into the database.
+ $this->assertFileUnchanged($result, File::load($result->id()));
+ // The target file should not have been altered.
+ $this->assertFileUnchanged($target, File::load($target->id()));
+ // Make sure we end up with two distinct files afterwards.
+ $this->assertDifferentFile($target, $result);
+
+ // Compare the source and results.
+ $loaded_source = File::load($source->id());
+ $this->assertEqual($loaded_source->id(), $result->id(), "Returned file's id matches the source.");
+ $this->assertNotEqual($loaded_source->getFileUri(), $source->getFileUri(), 'Returned file path has changed from the original.');
+ }
+
+ /**
+ * Test replacement when moving onto a file that already exists.
+ */
+ public function testExistingReplace() {
+ // Setup a file to overwrite.
+ $contents = $this->randomMachineName(10);
+ $source = $this->createFile(NULL, $contents);
+ $target = $this->createFile();
+ $this->assertDifferentFile($source, $target);
+
+ // Clone the object so we don't have to worry about the function changing
+ // our reference copy.
+ $result = file_move(clone $source, $target->getFileUri(), FILE_EXISTS_REPLACE);
+
+ // Look at the results.
+ $this->assertEqual($contents, file_get_contents($result->getFileUri()), 'Contents of file were overwritten.');
+ $this->assertFalse(file_exists($source->getFileUri()));
+ $this->assertTrue($result, 'File moved successfully.');
+
+ // Check that the correct hooks were called.
+ $this->assertFileHooksCalled(['move', 'update', 'delete', 'load']);
+
+ // Reload the file from the database and check that the changes were
+ // actually saved.
+ $loaded_result = File::load($result->id());
+ $this->assertFileUnchanged($result, $loaded_result);
+ // Check that target was re-used.
+ $this->assertSameFile($target, $loaded_result);
+ // Source and result should be totally different.
+ $this->assertDifferentFile($source, $loaded_result);
+ }
+
+ /**
+ * Test replacement when moving onto itself.
+ */
+ public function testExistingReplaceSelf() {
+ // Setup a file to overwrite.
+ $contents = $this->randomMachineName(10);
+ $source = $this->createFile(NULL, $contents);
+
+ // Copy the file over itself. Clone the object so we don't have to worry
+ // about the function changing our reference copy.
+ $result = file_move(clone $source, $source->getFileUri(), FILE_EXISTS_REPLACE);
+ $this->assertFalse($result, 'File move failed.');
+ $this->assertEqual($contents, file_get_contents($source->getFileUri()), 'Contents of file were not altered.');
+
+ // Check that no hooks were called while failing.
+ $this->assertFileHooksCalled([]);
+
+ // Load the file from the database and make sure it is identical to what
+ // was returned.
+ $this->assertFileUnchanged($source, File::load($source->id()));
+ }
+
+ /**
+ * Test that moving onto an existing file fails when FILE_EXISTS_ERROR is
+ * specified.
+ */
+ public function testExistingError() {
+ $contents = $this->randomMachineName(10);
+ $source = $this->createFile();
+ $target = $this->createFile(NULL, $contents);
+ $this->assertDifferentFile($source, $target);
+
+ // Clone the object so we don't have to worry about the function changing
+ // our reference copy.
+ $result = file_move(clone $source, $target->getFileUri(), FILE_EXISTS_ERROR);
+
+ // Check the return status and that the contents did not change.
+ $this->assertFalse($result, 'File move failed.');
+ $this->assertTrue(file_exists($source->getFileUri()));
+ $this->assertEqual($contents, file_get_contents($target->getFileUri()), 'Contents of file were not altered.');
+
+ // Check that no hooks were called while failing.
+ $this->assertFileHooksCalled([]);
+
+ // Load the file from the database and make sure it is identical to what
+ // was returned.
+ $this->assertFileUnchanged($source, File::load($source->id()));
+ $this->assertFileUnchanged($target, File::load($target->id()));
+ }
+
+}