Add filesystem.localToPublic event (#628)

octobercms · May 13, 2024 · 52e67e1 · 52e67e1
1 parent 8ec3f78
commit 52e67e1
Showing 1 changed file with 15 additions and 0 deletions.
diff --git a/src/Filesystem/Filesystem.php b/src/Filesystem/Filesystem.php
@@ -1,5 +1,6 @@
 <?php namespace October\Rain\Filesystem;
 
+use Event;
 use ReflectionClass;
 use FilesystemIterator;
 use Illuminate\Filesystem\Filesystem as FilesystemBase;
@@ -103,6 +104,20 @@ public function sizeToString($bytes)
      */
     public function localToPublic($path)
     {
+        /**
+         * @event filesystem.localToPublic
+         * Allow custom logic for converting local to public paths on non-standard installations.
+         *
+         * Example usage
+         *
+         *     Event::listen('filesystem.localToPublic', function ($path) {
+         *         return '/custom/public/path';
+         *     });
+         */
+        if (($event = Event::fire('filesystem.localToPublic', [$path], true)) !== null) {
+            return $event;
+        }
+
         // Check real paths
         $basePath = base_path();
         if (strpos($path, $basePath) === 0) {