added memory limit functions

src/PhPease/Php/functions.php

@@ -45,6 +45,11 @@ function get_file_upload_max_size_human_readable(): string
     return bytes_to_human_readable(get_file_upload_max_size());
 }
 
+/**
+ * helper function to work with file sizes in ini file format
+ * @param $size
+ * @return float
+ */
 function parse_ini_filesize($size): float
 {
     // Remove the non-unit characters from the size.
@@ -58,4 +63,35 @@ function parse_ini_filesize($size): float
     } else {
         return round($size);
     }
+}
+
+/**
+ * get memory limit in kilobytes
+ * @return false|float|int|string
+ */
+function get_memory_limit() {
+    $memory_limit = ini_get('memory_limit');
+    if (preg_match('/^(\d+)(.)$/', $memory_limit, $matches)) {
+        if ($matches[2] == 'M') {
+            $memory_limit = $matches[1] * 1024; // nnnM -> nnn MB
+        } else if ($matches[2] == 'K') {
+            $memory_limit = $matches[1]; // nnnK -> nnn KB
+        } else if ($matches[2] == 'G') {
+            $memory_limit = $matches[1] * 1024 * 1024; // nnnG -> nnn GB
+        }
+    }
+    return $memory_limit;
+}
+
+/**
+ * get remaining memory in kilobytes
+ * @return float|int
+ */
+function get_remaining_memory()
+{
+    $current_memory_usage = memory_get_usage(); // in bytes
+    $remaining_memory = get_memory_limit() * 1024 - $current_memory_usage; // in bytes
+
+    // convert remaining memory from bytes to kilobytes
+    return $remaining_memory / 1024;
 }

src/PhPease/functions_include.php

@@ -9,7 +9,6 @@
  */
 
 // for manual functions include
-require_once __DIR__ . '/Conf/functions.php';
 require_once __DIR__ . '/Convert/functions.php';
 require_once __DIR__ . '/Request/functions.php';
 require_once __DIR__ . '/String/functions.php';

tests/PhpFunctionsTest.php

@@ -1,5 +1,8 @@
 <?php declare(strict_types=1);
 use PHPUnit\Framework\TestCase;
+use function PhPease\Convert\kilobytes_to_human_readable;
+use function PhPease\Php\get_remaining_memory;
+use function PhPease\Php\get_memory_limit;
 use function PhPease\Php\parse_ini_filesize;
 
 final class PhpFunctionsTest extends TestCase
@@ -12,4 +15,23 @@ public function testParseIniFilesize()
         $this->assertEquals(2147483648, parse_ini_filesize('2G'));
         $this->assertEquals(400, parse_ini_filesize('400'));
     }
-}
+
+    public function test_get_memory_limit_128M()
+    {
+        ini_set('memory_limit', '128M');
+
+        $memLimit = get_memory_limit();
+
+        $this->assertEquals(131072, $memLimit);
+        $this->assertEquals('128.00 MB', kilobytes_to_human_readable($memLimit));
+    }
+
+    public function test_get_memory_limit_64M()
+    {
+        ini_set('memory_limit', '64M');
+
+        $memLimit = get_memory_limit();
+
+        $this->assertEquals(65536, $memLimit);
+        $this->assertEquals('64.00 MB', kilobytes_to_human_readable($memLimit));
+    }}