[ticket/16955] Resolve incompatibilities with doctum

PHPBB3-16955

phpBB/phpbb/db/doctrine/table_helper.php

@@ -21,7 +21,8 @@ class table_helper
 	 *
 	 * @param array $column_data Column data.
 	 *
-	 * @return array{string, array} A pair of type and array of column options.
+	 * @return array<string, array> A pair of type and array of column options.
+	 * @psalm-return array{string, array}
 	 */
 	public static function convert_column_data(array $column_data, string $dbms_layer): array
 	{

phpBB/phpbb/db/doctrine/type_converter.php

@@ -54,7 +54,8 @@ class type_converter
 	 *
 	 * @param string $type Legacy type name
 	 *
-	 * @return array{string, array} Pair of type name and options.
+	 * @return array<string, array> Pair of type name and options.
+	 * @psalm-return array{string, array}
 	 */
 	public static function convert(string $type, string $dbms): array
 	{

phpBB/phpbb/db/driver/driver.php

@@ -1102,7 +1102,8 @@ abstract class driver implements driver_interface
 	/**
 	 * Return sql error array
 	 *
-	 * @return array{message: string, code: int|string} SQL error array with message and error code
+	 * @return array SQL error array with message and error code
+	 * @psalm-return array{message: string, code: int|string}
 	 */
 	abstract protected function _sql_error(): array;
 

phpBB/phpbb/db/migrator.php

@@ -651,7 +651,8 @@ class migrator
 	* @param array $steps The steps to run
 	* @param bool|string $state Current state of the migration
 	* @param bool $revert true to revert a data step
-	* @return bool|array{result: mixed, step: int}  migration state. True if completed, serialized array if not finished
+	* @return bool|array migration state. True if completed, serialized array if not finished
+	* @psalm-return bool|array{result: mixed, step: int}
 	* @throws \phpbb\db\migration\exception
 	*/
 	protected function process_data_step($steps, $state, $revert = false)