improved phpDoc

dg · dg · commit fb2476b2f793 · 2021-11-24T18:58:06.000+01:00
diff --git a/src/Database/Connection.php b/src/Database/Connection.php
@@ -217,6 +217,7 @@ public function transaction(callable $callback)
 
 	/**
 	 * Generates and executes SQL query.
+	 * @param  literal-string  $sql
 	 */
 	public function query(string $sql, ...$params): ResultSet
 	{
@@ -240,7 +241,8 @@ public function queryArgs(string $sql, array $params): ResultSet
 
 
 	/**
-	 * @return array  [string, array]
+	 * @param  literal-string  $sql
+	 * @return array{string, array}
 	 */
 	public function preprocess(string $sql, ...$params): array
 	{
@@ -262,6 +264,7 @@ public function getLastQueryString(): ?string
 
 	/**
 	 * Shortcut for query()->fetch()
+	 * @param  literal-string  $sql
 	 */
 	public function fetch(string $sql, ...$params): ?Row
 	{
@@ -271,6 +274,7 @@ public function fetch(string $sql, ...$params): ?Row
 
 	/**
 	 * Shortcut for query()->fetchField()
+	 * @param  literal-string  $sql
 	 * @return mixed
 	 */
 	public function fetchField(string $sql, ...$params)
@@ -281,6 +285,7 @@ public function fetchField(string $sql, ...$params)
 
 	/**
 	 * Shortcut for query()->fetchFields()
+	 * @param  literal-string  $sql
 	 */
 	public function fetchFields(string $sql, ...$params): ?array
 	{
@@ -290,6 +295,7 @@ public function fetchFields(string $sql, ...$params): ?array
 
 	/**
 	 * Shortcut for query()->fetchPairs()
+	 * @param  literal-string  $sql
 	 */
 	public function fetchPairs(string $sql, ...$params): array
 	{
@@ -299,6 +305,7 @@ public function fetchPairs(string $sql, ...$params): array
 
 	/**
 	 * Shortcut for query()->fetchAll()
+	 * @param  literal-string  $sql
 	 */
 	public function fetchAll(string $sql, ...$params): array
 	{
diff --git a/src/Database/Explorer.php b/src/Database/Explorer.php
@@ -83,6 +83,7 @@ public function getInsertId(string $sequence = null): string
 
 	/**
 	 * Generates and executes SQL query.
+	 * @param  literal-string  $sql
 	 */
 	public function query(string $sql, ...$params): ResultSet
 	{
@@ -126,6 +127,7 @@ public function getConventions(): Conventions
 
 	/**
 	 * Shortcut for query()->fetch()
+	 * @param  literal-string  $sql
 	 */
 	public function fetch(string $sql, ...$params): ?Row
 	{
@@ -135,6 +137,7 @@ public function fetch(string $sql, ...$params): ?Row
 
 	/**
 	 * Shortcut for query()->fetchField()
+	 * @param  literal-string  $sql
 	 * @return mixed
 	 */
 	public function fetchField(string $sql, ...$params)
@@ -145,6 +148,7 @@ public function fetchField(string $sql, ...$params)
 
 	/**
 	 * Shortcut for query()->fetchFields()
+	 * @param  literal-string  $sql
 	 */
 	public function fetchFields(string $sql, ...$params): ?array
 	{
@@ -154,6 +158,7 @@ public function fetchFields(string $sql, ...$params): ?array
 
 	/**
 	 * Shortcut for query()->fetchPairs()
+	 * @param  literal-string  $sql
 	 */
 	public function fetchPairs(string $sql, ...$params): array
 	{
@@ -163,6 +168,7 @@ public function fetchPairs(string $sql, ...$params): array
 
 	/**
 	 * Shortcut for query()->fetchAll()
+	 * @param  literal-string  $sql
 	 */
 	public function fetchAll(string $sql, ...$params): array
 	{
