[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)

phpBB/phpbb/event/md_exporter.php

@@ -461,7 +461,8 @@ class md_exporter
 	* Validate "Changed" Information
 	*
 	* @param string $changed
-	* @return array{string, string} Changed information containing version and description in respective order
+	* @return array<string, string> Changed information containing version and description in respective order
+	* @psalm-return array{string, string}
 	* @throws \LogicException
 	*/
 	public function validate_changed($changed)

phpBB/phpbb/install/helper/iohandler/ajax_iohandler.php

@@ -82,7 +82,8 @@ class ajax_iohandler extends iohandler_base
 	protected $redirect_url;
 
 	/**
-	 * @var resource|closed-resource
+	 * @var resource
+	 * @psalm-var resource|closed-resource
 	 */
 	protected $file_lock_pointer;