[8.x] Add Filesystem::replaceInFile method (#38069)

* feature: introduce Filesystem::replaceInFile method

* tests: Filesystem::replaceInFile

* chore: keep params types inline with str_replace

src/Illuminate/Filesystem/Filesystem.php

@@ -211,6 +211,19 @@ public function replace($path, $content)
         rename($tempPath, $path);
     }
 
+    /**
+     * Replace a given string within a given file.
+     *
+     * @param  array|string  $search
+     * @param  array|string  $replace
+     * @param  string  $path
+     * @return void
+     */
+    public function replaceInFile($search, $replace, $path)
+    {
+        file_put_contents($path, str_replace($search, $replace, file_get_contents($path)));
+    }
+
     /**
      * Prepend to a file.
      *

tests/Filesystem/FilesystemTest.php

@@ -88,6 +88,17 @@ public function testReplaceCreatesFile()
         $this->assertStringEqualsFile($tempFile, 'Hello World');
     }
 
+    public function testReplaceInFileCorrectlyReplaces()
+    {
+        $tempFile = self::$tempDir.'/file.txt';
+
+        $filesystem = new Filesystem;
+
+        $filesystem->put($tempFile, 'Hello World');
+        $filesystem->replaceInFile('Hello World', 'Hello Taylor', $tempFile);
+        $this->assertStringEqualsFile($tempFile, 'Hello Taylor');
+    }
+
     public function testReplaceWhenUnixSymlinkExists()
     {
         if (windows_os()) {