updated

Author: Biuhub Studio

src/AbstractFileHandler.php

@@ -293,6 +293,11 @@ public function has_string(string $str): bool
         }
     }
 
+    public function match(string $pattern)
+    {
+        return $this->silencer->call('glob', $pattern, GLOB_ERR);
+    }
+
     /**
      * Match path against an extended wildcard pattern.
      *
@@ -389,8 +394,6 @@ public function put($contents, $lock = false)
      *
      * @param string $path
      * @param string $content
-     *
-     * @return void
      */
     public function replace($content = null)
     {
@@ -546,7 +549,7 @@ protected function _decode($var, $options = null): string
     public function mkdir($dir = null)
     {
         if ($dir !== null) {
-            $this->path = $dir;
+            $this->path = $this->silencer->call('dirname', $dir);
         }
 
         // Silence error for open_basedir; should fail in mkdir instead.
@@ -628,7 +631,7 @@ public function remove_dir($dir = null, $traverseSymlinks = false): bool
     /**
      * See unlink() or unset().
      *
-     * @return boolean
+     * @return bool
      */
     public function delete(): bool
     {
@@ -650,7 +653,7 @@ public function delete(): bool
     /**
      * Checks whether the file is a directory.
      *
-     * @return boolean
+     * @return bool
      */
     public function is_dir(): bool
     {
@@ -693,7 +696,7 @@ public function is_empty($exclude = []): bool
     /**
      * Checks whether the file is a regular file.
      *
-     * @return boolean
+     * @return bool
      */
     public function is_file(): bool
     {
@@ -847,7 +850,7 @@ public function free()
      * @param string $filename The filename to set the writable bit on
      * @param bool   $writable Whether to make the file writable or not
      *
-     * @return boolean
+     * @return bool
      */
     public function writable(bool $writable = true): bool
     {
@@ -864,7 +867,7 @@ public function writable(bool $writable = true): bool
      * @param string $filename The filename to set the readable bit on
      * @param bool   $readable Whether to make the file readable or not
      *
-     * @return boolean
+     * @return bool
      */
     public function readable(bool $readable = true): bool
     {
@@ -880,7 +883,7 @@ public function readable(bool $readable = true): bool
      *
      * @param bool $executable Whether to make the file executable or not
      *
-     * @return boolean
+     * @return bool
      */
     public function executable($executable = true): bool
     {

src/FileHandler.php

@@ -19,9 +19,14 @@
  * funtion usuage when it comes to php filesystem.
  *
  * @author Divine Niiquaye <[email protected]>
+ * @license MIT
  */
 class FileHandler extends AbstractFileHandler
 {
+    public function __construct()
+    {
+        parent::__construct();
+    }
     /**
      * Get relative path between target and base path. If path isn't relative, return full path.
      *
@@ -156,7 +161,7 @@ public function extension(): string
     /**
      * @return string
      */
-    public function real(): string
+    public function realpath(): string
     {
         if (isset($this->path)) {
             return $this->silencer->call('realpath', $this->path);
@@ -229,6 +234,47 @@ public function mime_type()
         }
     }
 
+    /**
+     * Creates a temporary directory.
+     *
+     * @param string $namespace the directory path in the system's temporary directory
+     * @param string $className the name of the test class
+     *
+     * @return string the path to the created directory
+     */
+    public function makeTmpDir(string $namespace, string $className): string
+    {
+        if (false !== ($pos = strrpos($className, '\\'))) {
+            $shortClass = substr($className, $pos + 1);
+        } else {
+            $shortClass = $className;
+        }
+
+        // Usage of realpath() is important if the temporary directory is a
+        // symlink to another directory (e.g. /var => /private/var on some Macs)
+        // We want to know the real path to avoid comparison failures with
+        // code that uses real paths only
+        $systemTempDir = str_replace('\\', '/', $this->silencer->call('realpath', sys_get_temp_dir()));
+        $basePath = $systemTempDir.'/'.$namespace.'/'.$shortClass;
+
+        $result = false;
+        $attempts = 0;
+
+        do {
+            $tmpDir = str_replace('/', DIRECTORY_SEPARATOR, $basePath.random_int(10000, 99999));
+
+            try {
+                $this->silencer->call('mkdir', $tmpDir, 0777);
+
+                $result = true;
+            } catch (FileException $exception) {
+                ++$attempts;
+            }
+        } while (false === $result && $attempts <= 10);
+
+        return $tmpDir;
+    }
+
     /**
      * Changes the file group.
      *