Merge pull request #7612 from ping-yee/230624_mix_in_helpers

docs: Replace type `mixed` in all helper files.

Author: kenjis

phpstan-baseline.neon.dist

@@ -155,11 +155,6 @@ parameters:
 			count: 1
 			path: system/Helpers/filesystem_helper.php
 
-		-
-			message: "#^Binary operation \"\\+\" between 0 and string results in an error\\.$#"
-			count: 1
-			path: system/Helpers/number_helper.php
-
 		-
 			message: "#^Property CodeIgniter\\\\Images\\\\Handlers\\\\BaseHandler\\:\\:\\$image \\(CodeIgniter\\\\Images\\\\Image\\) in empty\\(\\) is not falsy\\.$#"
 			count: 1

system/Helpers/array_helper.php

@@ -41,7 +41,7 @@ function dot_array_search(string $index, array $array)
      *
      * @internal This should not be used on its own.
      *
-     * @return mixed
+     * @return array|bool|float|int|object|string|null
      */
     function _array_search_dot(array $indexes, array $array)
     {
@@ -103,9 +103,9 @@ function _array_search_dot(array $indexes, array $array)
     /**
      * Returns the value of an element at a key in an array of uncertain depth.
      *
-     * @param mixed $key
+     * @param int|string $key
      *
-     * @return mixed|null
+     * @return array|bool|float|int|object|string|null
      */
     function array_deep_search($key, array $array)
     {

system/Helpers/cookie_helper.php

@@ -86,7 +86,7 @@ function get_cookie($index, bool $xssClean = false, ?string $prefix = '')
     /**
      * Delete a cookie
      *
-     * @param mixed  $name
+     * @param string $name
      * @param string $domain the cookie domain. Usually: .yourdomain.com
      * @param string $path   the cookie path
      * @param string $prefix the cookie prefix

system/Helpers/filesystem_helper.php

@@ -292,8 +292,8 @@ function get_dir_file_info(string $sourceDir, bool $topLevelOnly = true, bool $r
      * Options are: name, server_path, size, date, readable, writable, executable, fileperms
      * Returns false if the file cannot be found.
      *
-     * @param string $file           Path to file
-     * @param mixed  $returnedValues Array or comma separated string of information returned
+     * @param string       $file           Path to file
+     * @param array|string $returnedValues Array or comma separated string of information returned
      *
      * @return array|null
      */

system/Helpers/number_helper.php

@@ -15,8 +15,8 @@
     /**
      * Formats a numbers as bytes, based on size, and adds the appropriate suffix
      *
-     * @param mixed  $num    Will be cast as int
-     * @param string $locale
+     * @param int|string $num    Will be cast as int
+     * @param string     $locale
      *
      * @return bool|string
      */
@@ -69,14 +69,15 @@ function number_to_size($num, int $precision = 1, ?string $locale = null)
      *
      * @see https://simple.wikipedia.org/wiki/Names_for_large_numbers
      *
-     * @param string $num
+     * @param int|string $num
      *
      * @return bool|string
      */
     function number_to_amount($num, int $precision = 0, ?string $locale = null)
     {
         // Strip any formatting & ensure numeric input
         try {
+            // @phpstan-ignore-next-line
             $num = 0 + str_replace(',', '', $num);
         } catch (ErrorException $ee) {
             return false;

system/Helpers/text_helper.php

@@ -410,10 +410,10 @@ function word_wrap(string $str, int $charlim = 76): string
      *
      * This function will strip tags from a string, split it at its max_length and ellipsize
      *
-     * @param string $str       String to ellipsize
-     * @param int    $maxLength Max length of string
-     * @param mixed  $position  int (1|0) or float, .5, .2, etc for position to split
-     * @param string $ellipsis  ellipsis ; Default '...'
+     * @param string    $str       String to ellipsize
+     * @param int       $maxLength Max length of string
+     * @param float|int $position  int (1|0) or float, .5, .2, etc for position to split
+     * @param string    $ellipsis  ellipsis ; Default '...'
      *
      * @return string Ellipsized string
      */
@@ -446,9 +446,9 @@ function ellipsize(string $str, int $maxLength, $position = 1, string $ellipsis
      *
      * Removes slashes contained in a string or in an array
      *
-     * @param mixed $str string or array
+     * @param array|string $str string or array
      *
-     * @return mixed string or array
+     * @return array|string string or array
      */
     function strip_slashes($str)
     {