initial commit

backend/Services/Tmpfs/Adapters/Tmpfs.php

@@ -0,0 +1,136 @@
+<?php
+
+/*
+ * This file is part of the FileGator package.
+ *
+ * (c) Milos Stojanovic <alcalbg@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE file
+ */
+
+namespace Filegator\Services\Tmpfs\Adapters;
+
+use Filegator\Services\Service;
+use Filegator\Services\Tmpfs\TmpfsInterface;
+
+class Tmpfs implements Service, TmpfsInterface
+{
+    protected $path;
+
+    public function init(array $config = [])
+    {
+        $this->path = $config['path'];
+
+        if (! is_dir($this->path)) {
+            mkdir($this->path);
+        }
+
+        if (mt_rand(0, 99) < $config['gc_probability_perc']) {
+            $this->clean($config['gc_older_than']);
+        }
+    }
+
+    public function write(string $filename, $data)
+    {
+        $filename = $this->sanitizeFilename($filename);
+
+        file_put_contents($this->getPath().$filename, $data);
+    }
+
+    public function getFileLocation(string $filename): string
+    {
+        $filename = $this->sanitizeFilename($filename);
+
+        $realPath = $this->getPath().$filename;
+
+        if (! is_file($realPath)) {
+            touch($realPath);
+        }
+
+        return $realPath;
+    }
+
+    public function read(string $filename): string
+    {
+        $filename = $this->sanitizeFilename($filename);
+
+        return file_get_contents($this->getPath().$filename);
+    }
+
+    public function readStream(string $filename): array
+    {
+        $filename = $this->sanitizeFilename($filename);
+
+        $stream = fopen($this->getPath().$filename, 'r');
+
+        return [
+            'filename' => $filename,
+            'stream' => $stream,
+        ];
+    }
+
+    public function exists(string $filename): bool
+    {
+        $filename = $this->sanitizeFilename($filename);
+
+        return file_exists($this->getPath().$filename);
+    }
+
+    public function findAll($pattern): array
+    {
+        $files = [];
+
+        foreach (glob($this->getPath().$pattern) as $filename) {
+            if (is_file($filename)) {
+                $files[] = [
+                    'name' => basename($filename),
+                    'size' => filesize($filename),
+                    'time' => filemtime($filename),
+                ];
+            }
+        }
+
+        return $files;
+    }
+
+    public function remove(string $filename)
+    {
+        $filename = $this->sanitizeFilename($filename);
+
+        unlink($this->getPath().$filename);
+    }
+
+    public function clean(int $older_than)
+    {
+        $files = $this->findAll('*');
+        foreach ($files as $file) {
+            if (time() - $file['time'] >= $older_than) {
+                $this->remove($file['name']);
+            }
+        }
+    }
+
+    private function getPath(): string
+    {
+        return $this->path;
+    }
+
+    private function sanitizeFilename($filename)
+    {
+        $filename = preg_replace(
+            '~
+            [<>:"/\\|?*]|    # file system reserved https://en.wikipedia.org/wiki/Filename#Reserved_characters_and_words
+            [\x00-\x1F]|     # control characters http://msdn.microsoft.com/en-us/library/windows/desktop/aa365247%28v=vs.85%29.aspx
+            [\x7F\xA0\xAD]|  # non-printing characters DEL, NO-BREAK SPACE, SOFT HYPHEN
+            [;\\\{}^\~`]     # other non-safe
+            ~x',
+            '-',
+            $filename
+        );
+
+        // maximize filename length to 255 bytes http://serverfault.com/a/9548/44086
+        $ext = pathinfo($filename, PATHINFO_EXTENSION);
+
+        return mb_strcut(pathinfo($filename, PATHINFO_FILENAME), 0, 255 - ($ext ? strlen($ext) + 1 : 0), mb_detect_encoding($filename)).($ext ? '.'.$ext : '');
+    }
+}

backend/Services/Tmpfs/TmpfsInterface.php

@@ -0,0 +1,30 @@
+<?php
+
+/*
+ * This file is part of the FileGator package.
+ *
+ * (c) Milos Stojanovic <alcalbg@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE file
+ */
+
+namespace Filegator\Services\Tmpfs;
+
+interface TmpfsInterface
+{
+    public function exists(string $filename): bool;
+
+    public function findAll($pattern): array;
+
+    public function write(string $filename, $data);
+
+    public function read(string $filename): string;
+
+    public function readStream(string $filename): array;
+
+    public function remove(string $filename);
+
+    public function getFileLocation(string $filename): string;
+
+    public function clean(int $older_than);
+}