refactor: replace type mixed with more specific types (#10345)

* refactor: replace narrowable mixed PHPDocs with specific types

* refactor: collapse long form `mixed` to just `mixed`

Author: paulbalandan

system/Common.php

@@ -403,9 +403,9 @@ function db_connect($db = null, bool $getShared = true)
      * retrieving values set from the .env file for
      * use in config files.
      *
-     * @param array<int|string, mixed>|bool|float|int|object|string|null $default
+     * @param mixed $default
      *
-     * @return array<int|string, mixed>|bool|float|int|object|string|null
+     * @return mixed
      */
     function env(string $key, $default = null)
     {
@@ -1080,7 +1080,7 @@ function session(?string $val = null)
      *  - $timer = service('timer')
      *  - $timer = \CodeIgniter\Config\Services::timer();
      *
-     * @param array|bool|float|int|object|string|null ...$params
+     * @param mixed ...$params
      */
     function service(string $name, ...$params): ?object
     {
@@ -1096,7 +1096,7 @@ function service(string $name, ...$params): ?object
     /**
      * Always returns a new instance of the class.
      *
-     * @param array|bool|float|int|object|string|null ...$params
+     * @param mixed ...$params
      */
     function single_service(string $name, ...$params): ?object
     {

system/Config/BaseConfig.php

@@ -166,7 +166,7 @@ protected function parseEncryptionKey(string $key): string
     /**
      * Initialization an environment-specific configuration setting
      *
-     * @param array|bool|float|int|string|null $property
+     * @param array<int|string, mixed>|bool|float|int|string|null $property
      *
      * @return void
      */

system/Config/BaseService.php

@@ -244,7 +244,7 @@ public static function override(string $key, object $value): void
      *
      * $key must be a name matching a service.
      *
-     * @param array|bool|float|int|object|string|null ...$params
+     * @param mixed ...$params
      *
      * @return object
      */

system/Database/BaseBuilder.php

@@ -2817,7 +2817,7 @@ public function getCompiledDelete(bool $reset = true): string
     /**
      * Compiles a delete string and runs the query
      *
-     * @param array|RawSql|string $where
+     * @param array<int|string, mixed>|RawSql|string $where
      *
      * @return bool|string Returns a SQL string if in test mode.
      *
@@ -3075,7 +3075,7 @@ protected function trackAliases($table)
      * Generates a query string based on which functions were used.
      * Should not be called directly.
      *
-     * @param mixed $selectOverride
+     * @param false|string $selectOverride
      */
     protected function compileSelect($selectOverride = false): string
     {

system/Database/BaseConnection.php

@@ -781,7 +781,7 @@ abstract protected function execute(string $sql);
      * Should automatically handle different connections for read/write
      * queries if needed.
      *
-     * @param array|string|null $binds
+     * @param array<int|string, mixed>|string|null $binds
      *
      * @return BaseResult<TConnection, TResult>|bool|Query
      *
@@ -1533,7 +1533,7 @@ abstract public function affectedRows(): int;
      * Escapes data based on type.
      * Sets boolean and null types
      *
-     * @param array|bool|float|int|object|string|null $str
+     * @param mixed $str
      *
      * @return ($str is array ? array : float|int|string)
      */
@@ -2059,7 +2059,7 @@ protected function _enableForeignKeyChecks()
     /**
      * Accessor for properties if they exist.
      *
-     * @return array|bool|float|int|object|resource|string|null
+     * @return mixed
      */
     public function __get(string $key)
     {

system/Database/BaseUtils.php

@@ -125,7 +125,7 @@ public function optimizeTable(string $tableName)
     /**
      * Optimize Database
      *
-     * @return mixed
+     * @return array<string, mixed>|bool
      *
      * @throws DatabaseException
      */
@@ -170,7 +170,7 @@ public function optimizeDatabase()
     /**
      * Repair Table
      *
-     * @return mixed
+     * @return array<string, mixed>|bool
      *
      * @throws DatabaseException
      */

system/Database/ConnectionInterface.php

@@ -100,7 +100,7 @@ public function getVersion(): string;
      * Should automatically handle different connections for read/write
      * queries if needed.
      *
-     * @param array|string|null $binds
+     * @param array<int|string, mixed>|string|null $binds
      *
      * @return BaseResult<TConnection, TResult>|bool|Query
      */
@@ -137,7 +137,7 @@ public function getLastQuery();
      * Escapes data based on type.
      * Sets boolean and null types.
      *
-     * @param array|bool|float|int|object|string|null $str
+     * @param mixed $str
      *
      * @return ($str is array ? array : float|int|string)
      */
@@ -149,7 +149,7 @@ public function escape($str);
      *
      * @param array ...$params
      *
-     * @return array|bool|float|int|object|resource|string|null
+     * @return mixed
      */
     public function callFunction(string $functionName, ...$params);
 

system/Database/OCI8/Builder.php

@@ -150,7 +150,7 @@ protected function _truncate(string $table): string
     /**
      * Compiles a delete string and runs the query
      *
-     * @param mixed $where
+     * @param array<int|string, mixed>|RawSql|string $where
      *
      * @return bool|string
      *

system/Database/Postgre/Builder.php

@@ -225,7 +225,7 @@ protected function _insertBatch(string $table, array $keys, array $values): stri
     /**
      * Compiles a delete string and runs the query
      *
-     * @param mixed $where
+     * @param array<int|string, mixed>|RawSql|string $where
      *
      * @return bool|string
      *

system/Database/Postgre/Connection.php

@@ -241,7 +241,7 @@ public function affectedRows(): int
      *
      * Escapes data based on type
      *
-     * @param array|bool|float|int|object|string|null $str
+     * @param mixed $str
      *
      * @return ($str is array ? array : float|int|string)
      */