DB\IO phpdoc and phpstan fixes

www/includes/edit_base.php

@@ -116,6 +116,7 @@ $ADMIN_STYLESHEET = 'edit.css';
 // define all needed smarty stuff for the general HTML/page building
 $HEADER['CSS'] = CSS;
 $HEADER['DEFAULT_ENCODING'] = DEFAULT_ENCODING;
+/** @phpstan-ignore-next-line because ADMIN_STYLESHEET can be null */
 $HEADER['STYLESHEET'] = $ADMIN_STYLESHEET ?? ADMIN_STYLESHEET;
 
 if ($form->my_page_name == 'edit_order') {

www/lib/CoreLibs/DB/IO.php

@@ -1481,7 +1481,7 @@ class IO
 	 * @param  string $string string to escape
 	 * @return string         escaped string
 	 */
-	public function dbEscapeIdentifier($string): string
+	public function dbEscapeIdentifier(string $string): string
 	{
 		return $this->db_functions->__dbEscapeIdentifier($string);
 	}
@@ -1489,14 +1489,19 @@ class IO
 	/**
 	 * escape data for writing to bytea type column field
 	 * @param  string $data data to escape to bytea
-	 * @return string       escaped bytea
+	 * @return string       escaped bytea string
 	 */
-	public function dbEscapeBytea($data)
+	public function dbEscapeBytea(string $data): string
 	{
 		return $this->db_functions->__dbEscapeBytea($data);
 	}
 
-	public function dbUnescapeBytea($bytea)
+	/**
+	 * unescape bytea data back to normal binrary data
+	 * @param  string $bytea bytea data stream
+	 * @return string        binary data string
+	 */
+	public function dbUnescapeBytea(string $bytea): string
 	{
 		return $this->db_functions->__dbUnescapeBytea($bytea);
 	}
@@ -1816,6 +1821,7 @@ class IO
 
 		// if cursor exists ...
 		if ($this->cursor_ext[$query_hash]['cursor']) {
+			/** @phpstan-ignore-next-line claims this is always false, but can be true */
 			if ($first_call === true) {
 				$this->cursor_ext[$query_hash]['log'][] = 'First call';
 				// count the rows returned (if select)

www/lib/CoreLibs/DB/SQL/SqlInterface/SqlFunctions.php

@@ -214,7 +214,7 @@ interface SqlFunctions
 	/**
 	 * Undocumented function
 	 *
-	 * @param string $bytea
+	 * @param string $data
 	 * @return string
 	 */
 	public function __dbEscapeBytea(string $data): string;