used PhpStorm Language attribute

Author: dg

composer.json

@@ -18,7 +18,8 @@
 		"php": "7.2 - 8.3",
 		"ext-pdo": "*",
 		"nette/caching": "^3.0",
-		"nette/utils": "^3.2.1 || ~4.0.0"
+		"nette/utils": "^3.2.1 || ~4.0.0",
+		"jetbrains/phpstorm-attributes": "dev-master"
 	},
 	"require-dev": {
 		"nette/tester": "^2.4",

src/Database/Connection.php

@@ -9,6 +9,7 @@
 
 namespace Nette\Database;
 
+use JetBrains\PhpStorm\Language;
 use Nette;
 use Nette\Utils\Arrays;
 use PDO;
@@ -226,7 +227,12 @@ public function transaction(callable $callback)
 	 * Generates and executes SQL query.
 	 * @param  literal-string  $sql
 	 */
-	public function query(string $sql, ...$params): ResultSet
+	public function query(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): ResultSet
 	{
 		[$this->sql, $params] = $this->preprocess($sql, ...$params);
 		try {
@@ -274,7 +280,12 @@ public function getLastQueryString(): ?string
 	 * Shortcut for query()->fetch()
 	 * @param  literal-string  $sql
 	 */
-	public function fetch(string $sql, ...$params): ?Row
+	public function fetch(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): ?Row
 	{
 		return $this->query($sql, ...$params)->fetch();
 	}
@@ -285,8 +296,12 @@ public function fetch(string $sql, ...$params): ?Row
 	 * @param  literal-string  $sql
 	 * @return mixed
 	 */
-	public function fetchField(string $sql, ...$params)
-	{
+	public function fetchField(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	) {
 		return $this->query($sql, ...$params)->fetchField();
 	}
 
@@ -295,7 +310,12 @@ public function fetchField(string $sql, ...$params)
 	 * Shortcut for query()->fetchFields()
 	 * @param  literal-string  $sql
 	 */
-	public function fetchFields(string $sql, ...$params): ?array
+	public function fetchFields(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): ?array
 	{
 		return $this->query($sql, ...$params)->fetchFields();
 	}
@@ -305,7 +325,12 @@ public function fetchFields(string $sql, ...$params): ?array
 	 * Shortcut for query()->fetchPairs()
 	 * @param  literal-string  $sql
 	 */
-	public function fetchPairs(string $sql, ...$params): array
+	public function fetchPairs(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): array
 	{
 		return $this->query($sql, ...$params)->fetchPairs();
 	}
@@ -315,7 +340,12 @@ public function fetchPairs(string $sql, ...$params): array
 	 * Shortcut for query()->fetchAll()
 	 * @param  literal-string  $sql
 	 */
-	public function fetchAll(string $sql, ...$params): array
+	public function fetchAll(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): array
 	{
 		return $this->query($sql, ...$params)->fetchAll();
 	}

src/Database/Explorer.php

@@ -9,6 +9,7 @@
 
 namespace Nette\Database;
 
+use JetBrains\PhpStorm\Language;
 use Nette;
 use Nette\Database\Conventions\StaticConventions;
 
@@ -85,7 +86,12 @@ public function getInsertId(?string $sequence = null): string
 	 * Generates and executes SQL query.
 	 * @param  literal-string  $sql
 	 */
-	public function query(string $sql, ...$params): ResultSet
+	public function query(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): ResultSet
 	{
 		return $this->connection->query($sql, ...$params);
 	}
@@ -129,7 +135,12 @@ public function getConventions(): Conventions
 	 * Shortcut for query()->fetch()
 	 * @param  literal-string  $sql
 	 */
-	public function fetch(string $sql, ...$params): ?Row
+	public function fetch(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): ?Row
 	{
 		return $this->connection->query($sql, ...$params)->fetch();
 	}
@@ -140,8 +151,12 @@ public function fetch(string $sql, ...$params): ?Row
 	 * @param  literal-string  $sql
 	 * @return mixed
 	 */
-	public function fetchField(string $sql, ...$params)
-	{
+	public function fetchField(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	) {
 		return $this->connection->query($sql, ...$params)->fetchField();
 	}
 
@@ -150,7 +165,12 @@ public function fetchField(string $sql, ...$params)
 	 * Shortcut for query()->fetchFields()
 	 * @param  literal-string  $sql
 	 */
-	public function fetchFields(string $sql, ...$params): ?array
+	public function fetchFields(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): ?array
 	{
 		return $this->connection->query($sql, ...$params)->fetchFields();
 	}
@@ -160,7 +180,12 @@ public function fetchFields(string $sql, ...$params): ?array
 	 * Shortcut for query()->fetchPairs()
 	 * @param  literal-string  $sql
 	 */
-	public function fetchPairs(string $sql, ...$params): array
+	public function fetchPairs(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): array
 	{
 		return $this->connection->query($sql, ...$params)->fetchPairs();
 	}
@@ -170,7 +195,12 @@ public function fetchPairs(string $sql, ...$params): array
 	 * Shortcut for query()->fetchAll()
 	 * @param  literal-string  $sql
 	 */
-	public function fetchAll(string $sql, ...$params): array
+	public function fetchAll(
+		#[Language('SQL')]
+		string $sql,
+		#[Language('GenericSQL')]
+		...$params
+	): array
 	{
 		return $this->connection->query($sql, ...$params)->fetchAll();
 	}