0.3.0

KarelWintersky · KarelWintersky · commit b3f4d5273ae3 · 2021-06-21T14:36:48.000+03:00
diff --git a/.gitattributes b/.gitattributes
@@ -4,6 +4,10 @@
 .git			    export-ignore
 .gitattributes		export-ignore
 .gitignore		    export-ignore
-/vendor			    export-ignore
-/docs		        export-ignore
+.github             export-ignore
+phpunit.xml         export-ignore
+CHANGELOG.md        export-ignore
 
+vendor			    export-ignore
+docs		        export-ignore
+tests               export-ignore
diff --git a/README.md b/README.md
@@ -2,3 +2,9 @@
 
 Helpers for Arris µ-Framework 
 
+
+---
+Other helpers:
+
+https://github.com/AgelxNash/functions
+
diff --git a/sources/Helpers/Arr.php b/sources/Helpers/Arr.php
@@ -49,8 +49,14 @@ public static function map_to_integer($input): array
      */
     public static function map($input, callable $callback):array
     {
-        if (!is_array($input) || empty($input)) return [];
-        if (!is_callable($callback)) $callback = static function() {};
+        if (!is_array($input) || empty($input)) {
+            return [];
+        }
+        
+        if (!is_callable($callback)) {
+            $callback = static function() {
+            };
+        }
     
         return array_map($callback, $input);
     }
@@ -80,6 +86,8 @@ function fill_like_list(array &$target_array, array $indexes, array $source_arra
      * Sort array in given order by key
      * Returns array
      *
+     * Alias of array_sort_in_given_order()
+     *
      * @param $array - array for sort [ [ id, data...], [ id, data...], ...  ]
      * @param $order - order (as array of sortkey values) [ id1, id2, id3...]
      * @param $sort_key - sorting key (id)
@@ -95,6 +103,40 @@ public static function sort_with_order(array $array, array $order, $sort_key):ar
         return $array;
     }
     
+    public static function filter(array $input, $callback = null, $flag = 0)
+    {
+        return array_filter($input, $callback, $flag);
+    }
+    
+    /**
+     *
+     *
+     * @param array $input
+     * @param callable $callback
+     * @return array|mixed|null
+     */
+    public static function searchCallback(array $input, callable $callback)
+    {
+        if (!is_array($input) || empty($input)) {
+            return [];
+        }
+    
+        if (!is_callable($callback)) {
+            $callback = static function() { };
+        }
+    
+        foreach ($input as $item) {
+            $v = \call_user_func($callback, $item);
+            if ( $v === true ) {
+                return $item;
+            }
+        }
+        return null;
+        
+    }
+    
+    
+    
 }
 
 # -eof-
diff --git a/sources/Helpers/Debug.php b/sources/Helpers/Debug.php
@@ -0,0 +1,59 @@
+<?php
+
+
+namespace Arris\Helpers;
+
+
+class Debug
+{
+    
+    /**
+     * Печать массива в том виде, в каком его понимает php
+     *
+     * @param $array
+     * @param int $level
+     * @return string
+     */
+    public static function array_code($array, $level = 1)
+    {
+        $php = $tabs = $breaks = '';
+        if (is_array($arr)) {
+            for ($n = 0; $n < $level; $n++) {
+                $tabs .= "\t";
+                if ($n > 0) {
+                    $breaks .= "\t";
+                }
+            }
+            $vals = [];
+            foreach ($arr as $key => $val) {
+                $vals[] = is_array($val) ?
+                    "'" . $key . "'=>" . self::array_code($val, $level + 1) :
+                    "'" . $key . "'=>'" . $val . "'";
+            }
+            $php = "array(\r" . $tabs . implode(",\r" . $tabs, $vals) . "\r" . $breaks . ")";
+        }
+    
+        return $php;
+    }
+    
+    /**
+     * Возможность вызвать любой метод (даже приватный)
+     *
+     * @param $object
+     * @param $method
+     * @param array $args
+     * @return mixed
+     * @throws \ReflectionException
+     */
+    public static function callMethod($object, $method, $args = [])
+    {
+        $classReflection = new \ReflectionClass(get_class($object));
+        $methodReflection = $classReflection->getMethod($method);
+        $methodReflection->setAccessible(true);
+        $result = $methodReflection->invokeArgs($object, $args);
+        $methodReflection->setAccessible(false);
+    
+        return $result;
+    }
+    
+}
diff --git a/sources/Helpers/FS.php b/sources/Helpers/FS.php
@@ -14,19 +14,78 @@ class FS
      */
     public static function rmdir($directory): bool
     {
-        if (!is_dir($directory)) {
+        if (!is_dir( $directory )) {
             return false;
         }
         
-        $files = array_diff(scandir($directory), ['.', '..']);
+        $files = array_diff( scandir( $directory ), [ '.', '..' ] );
         
         foreach ($files as $file) {
             $target = "{$directory}/{$file}";
-            (is_dir($target))
-                ? self::rmdir($target)
-                : unlink($target);
+            (is_dir( $target ))
+                ? self::rmdir( $target )
+                : unlink( $target );
         }
-        return rmdir($directory);
+        return rmdir( $directory );
     }
-
+    
+    /**
+     * Максимальный размер закачиваемого файла
+     *
+     * @return mixed
+     */
+    public static function getMaxUploadSize()
+    {
+        $max_upload = (int)(ini_get( 'upload_max_filesize' ));
+        $max_post = (int)(ini_get( 'post_max_size' ));
+        $memory_limit = (int)(ini_get( 'memory_limit' ));
+        return min( $max_upload, $max_post, $memory_limit );
+    }
+    
+    /**
+     * Finds path, relative to the given root folder, of all files and directories in the given directory and its sub-directories non recursively.
+     * Will return an array of the form
+     * array(
+     *   'files' => [],
+     *   'dirs'  => [],
+     * )
+     *
+     * @param string $root
+     * @return array[]
+     */
+    public static function read_all_files($root = '.')
+    {
+        $directory_content = [ 'files' => [], 'dirs' => [] ];
+        $directories = array();
+        $last_letter = $root[ strlen( $root ) - 1 ];
+        $root
+            = ($last_letter === '\\' || $last_letter === '/')
+            ? $root
+            : $root.DIRECTORY_SEPARATOR;
+        
+        $directories[] = $root;
+        
+        while (count( $directories )) {
+            $dir = array_pop( $directories );
+            if ($handle = opendir( $dir )) {
+                while (false !== ($file = readdir( $handle ))) {
+                    if ($file === '.' || $file === '..') {
+                        continue;
+                    }
+                    $file = $dir.$file;
+                    if (is_dir( $file )) {
+                        $directory_path = $file . DIRECTORY_SEPARATOR;
+                        $directories[] = $directory_path;
+                        $directory_content[ 'dirs' ][] = $directory_path;
+                    } elseif (is_file( $file )) {
+                        $directory_content[ 'files' ][] = $file;
+                    }
+                }
+                closedir( $handle );
+            }
+        }
+        
+        return $directory_content;
+    }
+    
 }
diff --git a/sources/Helpers/HTTP.php b/sources/Helpers/HTTP.php
@@ -4,18 +4,7 @@
 
 class HTTP
 {
-    /**
-     * Проверяет, является ли переданная строка корректным URL (http/https/ftp), включая IDN
-     *
-     * @param $url
-     * @return false|int
-     */
-    public static function filter_validate_url($url)
-    {
-        return preg_match('#((https?|ftp)://(\S*?\.\S*?))([\s)\[\]{},;"\':<]|\.\s|$)#i', $url);
-    }
-    
-    public function getIP()
+    public static function getIP()
     {
         if (php_sapi_name() === 'cli') return '127.0.0.1';
         
@@ -34,4 +23,24 @@ public function getIP()
         return filter_var($_SERVER['REMOTE_ADDR'], FILTER_VALIDATE_IP) ? $_SERVER['REMOTE_ADDR'] : NULL;
     }
     
+    /**
+     *
+     * @param $file_post
+     * @return array
+     */
+    public static function reArrangeFilesPOST($file_post)
+    {
+        $rearranged_files = [];
+        $file_count = count($file_post['name']);
+        $file_keys = array_keys($file_post);
+    
+        for ($i = 0; $i < $file_count; $i++) {
+            foreach ($file_keys as $key) {
+                $rearranged_files[$i][$key] = $file_post[$key][$i];
+            }
+        }
+    
+        return $rearranged_files;
+    }
+    
 }
diff --git a/sources/Helpers/Misc.php b/sources/Helpers/Misc.php
@@ -0,0 +1,38 @@
+<?php
+
+
+namespace Arris\Helpers;
+
+/**
+ * Class Misc
+ *
+ * Методы, не вошедшие (пока) в другие классы
+ *
+ * @package Arris\Helpers
+ */
+class Misc
+{
+    /**
+     * Generate GUID
+     *
+     * @return string
+     */
+    public static function GUID()
+    {
+        if (function_exists('\com_create_guid') === true) {
+            return trim(com_create_guid(), '{}');
+        }
+    
+        if (function_exists('openssl_random_pseudo_bytes') === true) {
+            $data = openssl_random_pseudo_bytes(16);
+            $data[6] = chr(ord($data[6]) & 0x0f | 0x40); // set version to 0100
+            $data[8] = chr(ord($data[8]) & 0x3f | 0x80); // set bits 6-7 to 10
+            return strtoupper( vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($data), 4)) );
+        }
+    
+        return sprintf('%04X%04X-%04X-%04X-%04X-%04X%04X%04X', mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(16384, 20479), mt_rand(32768, 49151), mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(0, 65535));
+    }
+    
+    
+    
+}
diff --git a/sources/Helpers/Str.php b/sources/Helpers/Str.php
@@ -6,6 +6,7 @@ class Str
 {
     /**
      * trims text to a space then adds ellipses if desired
+     *
      * @param string $input text to trim
      * @param int $length in characters to trim to
      * @param bool $ellipses if ellipses (...) are to be added
@@ -119,5 +120,35 @@ function($m) use ($map) { return $m[1].'%'.($map[$m[2]] + 1).'$'; },
         return vsprintf($new_str, $args);
     }
     
+    /**
+     * pluralForm - форма числительного
+     *
+     * @param $number
+     * @param mixed $forms (array or string with glues, x|y|z or [x,y,z]
+     * @param string $glue
+     * @return string
+     */
+    public static function pluralForm($number, $forms, string $glue = '|'):string
+    {
+        if (is_string($forms)) {
+            $forms = explode($forms, $glue);
+        } elseif (!is_array($forms)) {
+            return '';
+        }
+    
+        if (3 != count($forms)) {
+            return '';
+        }
+    
+        return
+            ($number % 10 == 1 && $number % 100 != 11)
+                ? $forms[0]
+                : (
+            ($number % 10 >= 2 && $number % 10 <= 4 && ($number % 100 < 10 || $number % 100 >= 20))
+                ? $forms[1]
+                : $forms[2]
+            );
+    }
+    
     
 }
diff --git a/sources/Helpers/Url.php b/sources/Helpers/Url.php
