Miglioramento della gestione delle funzioni

Miglioramento delle condizioni di aggiunta delle funzioni PHP dentro al file lib/util.php, con miglioramento della documentazione in lib/functions.php.

lib/functions.php

@@ -742,6 +742,7 @@ function tr($string, $parameters = [], $domain = null, $locale = null)
     return Translator::translate($string, $parameters, $domain, $locale);
 }
 
+// Retrocompatibilità
 if (!function_exists('_')) {
     function _($string, $parameters = [], $domain = null, $locale = null)
     {
@@ -775,7 +776,7 @@ function get_var($nome, $sezione = null, $descrizione = false, $again = false)
  *
  * @return string
  */
-function filter($param, $rule = 'text', $method = null)
+function filter($param, $method = null)
 {
     return Filter::getValue($param, $method = null);
 }
@@ -810,11 +811,25 @@ function get($param, $rule = 'text')
     return Filter::getValue($param, 'get');
 }
 
+/**
+ * Controlla se è in corso una richiesta AJAX generata dal progetto.
+ *
+ * @return bool
+ */
 function isAjaxRequest()
 {
     return \Whoops\Util\Misc::isAjaxRequest() && filter('ajax') !== null;
 }
 
+/**
+ * Esegue una somma precisa tra due interi/array.
+ *
+ * @param array|float $first
+ * @param array|float $second
+ * @param int         $decimals
+ *
+ * @return float
+ */
 function sum($first, $second = null, $decimals = null)
 {
     $first = (array) $first;

lib/util.php

@@ -302,7 +302,8 @@ if (!function_exists('isHTTPS')) {
     }
 }
 
-/**
+if (!function_exists('color_darken')) {
+    /**
      * Scurisce un determinato colore.
      *
      * @param unknown $color
@@ -310,8 +311,8 @@ if (!function_exists('isHTTPS')) {
      *
      * @return string
      */
-function color_darken($color, $dif = 20)
-{
+    function color_darken($color, $dif = 20)
+    {
         $color = str_replace('#', '', $color);
         if (strlen($color) != 6) {
             return '000000';
@@ -324,9 +325,11 @@ function color_darken($color, $dif = 20)
         }
 
         return '#'.$rgb;
+    }
 }
 
-/**
+if (!function_exists('color_inverse')) {
+    /**
      * Inverte il colore inserito.
      *
      * @see http://www.splitbrain.org/blog/2008-09/18-calculating_color_contrast_with_php
@@ -335,8 +338,8 @@ function color_darken($color, $dif = 20)
      *
      * @return string
      */
-function color_inverse($start_colour)
-{
+    function color_inverse($start_colour)
+    {
         $R1 = hexdec(substr($start_colour, 1, 2));
         $G1 = hexdec(substr($start_colour, 3, 2));
         $B1 = hexdec(substr($start_colour, 5, 2));
@@ -355,9 +358,11 @@ function color_inverse($start_colour)
         } else {
             return '#000';
         }
+    }
 }
 
-/**
+if (!function_exists('readSQLFile')) {
+    /**
      * Restituisce l'insieme delle query presente nel file specificato.
      *
      * @param string $filename  Percorso per il file
@@ -367,8 +372,8 @@ function color_inverse($start_colour)
      *
      * @return array
      */
-function readSQLFile($filename, $delimiter = ';')
-{
+    function readSQLFile($filename, $delimiter = ';')
+    {
         $inString = false;
         $escChar = false;
         $query = '';
@@ -419,4 +424,5 @@ function readSQLFile($filename, $delimiter = ';')
         } while (next($sqlRows) !== false);
 
         return $queryLine;
+    }
 }