[10.x] Filesystem : can lock file on append of content (#49262)

* [10.x] Can lock file on append of content

* Update facade docblocks

* Update Filesystem.php

---------

Co-authored-by: StephaneBour <StephaneBour@users.noreply.github.com>
Co-authored-by: Taylor Otwell <taylor@laravel.com>

src/Illuminate/Filesystem/Filesystem.php

@@ -268,11 +268,12 @@ public function prepend($path, $data)
      *
      * @param  string  $path
      * @param  string  $data
+     * @param  bool  $lock
      * @return int
      */
-    public function append($path, $data)
+    public function append($path, $data, $lock = false)
     {
-        return file_put_contents($path, $data, FILE_APPEND);
+        return file_put_contents($path, $data, FILE_APPEND | ($lock ? LOCK_EX : 0));
     }
 
     /**

src/Illuminate/Support/Facades/File.php

@@ -16,7 +16,7 @@
  * @method static void replace(string $path, string $content, int|null $mode = null)
  * @method static void replaceInFile(array|string $search, array|string $replace, string $path)
  * @method static int prepend(string $path, string $data)
- * @method static int append(string $path, string $data)
+ * @method static int append(string $path, string $data, bool $lock = false)
  * @method static mixed chmod(string $path, int|null $mode = null)
  * @method static bool delete(string|array $paths)
  * @method static bool move(string $path, string $target)