1
0
mirror of https://github.com/dg/dibi.git synced 2025-08-08 15:16:58 +02:00

used PhpStorm Language attribute

This commit is contained in:
David Grudl
2023-09-29 15:56:30 +02:00
parent 92b8e6077e
commit 6cc7ce8e44
2 changed files with 12 additions and 10 deletions

View File

@@ -17,7 +17,8 @@
"tracy/tracy": "^2.9", "tracy/tracy": "^2.9",
"nette/tester": "^2.5", "nette/tester": "^2.5",
"nette/di": "^3.1", "nette/di": "^3.1",
"phpstan/phpstan": "^1.0" "phpstan/phpstan": "^1.0",
"jetbrains/phpstorm-attributes": "^1.0"
}, },
"replace": { "replace": {
"dg/dibi": "*" "dg/dibi": "*"

View File

@@ -9,6 +9,7 @@ declare(strict_types=1);
namespace Dibi; namespace Dibi;
use JetBrains\PhpStorm\Language;
use Traversable; use Traversable;
@@ -209,7 +210,7 @@ class Connection implements IConnection
* Generates (translates) and executes SQL query. * Generates (translates) and executes SQL query.
* @throws Exception * @throws Exception
*/ */
final public function query(mixed ...$args): Result final public function query(#[Language('GenericSQL')] mixed ...$args): Result
{ {
return $this->nativeQuery($this->translate(...$args)); return $this->nativeQuery($this->translate(...$args));
} }
@@ -219,7 +220,7 @@ class Connection implements IConnection
* Generates SQL query. * Generates SQL query.
* @throws Exception * @throws Exception
*/ */
final public function translate(mixed ...$args): string final public function translate(#[Language('GenericSQL')] mixed ...$args): string
{ {
if (!$this->driver) { if (!$this->driver) {
$this->connect(); $this->connect();
@@ -232,7 +233,7 @@ class Connection implements IConnection
/** /**
* Generates and prints SQL query. * Generates and prints SQL query.
*/ */
final public function test(mixed ...$args): bool final public function test(#[Language('GenericSQL')] mixed ...$args): bool
{ {
try { try {
Helpers::dump($this->translate(...$args)); Helpers::dump($this->translate(...$args));
@@ -254,7 +255,7 @@ class Connection implements IConnection
* Generates (translates) and returns SQL query as DataSource. * Generates (translates) and returns SQL query as DataSource.
* @throws Exception * @throws Exception
*/ */
final public function dataSource(mixed ...$args): DataSource final public function dataSource(#[Language('GenericSQL')] mixed ...$args): DataSource
{ {
return new DataSource($this->translate(...$args), $this); return new DataSource($this->translate(...$args), $this);
} }
@@ -264,7 +265,7 @@ class Connection implements IConnection
* Executes the SQL query. * Executes the SQL query.
* @throws Exception * @throws Exception
*/ */
final public function nativeQuery(string $sql): Result final public function nativeQuery(#[Language('SQL')] string $sql): Result
{ {
if (!$this->driver) { if (!$this->driver) {
$this->connect(); $this->connect();
@@ -593,7 +594,7 @@ class Connection implements IConnection
* Executes SQL query and fetch result - shortcut for query() & fetch(). * Executes SQL query and fetch result - shortcut for query() & fetch().
* @throws Exception * @throws Exception
*/ */
public function fetch(mixed ...$args): ?Row public function fetch(#[Language('GenericSQL')] mixed ...$args): ?Row
{ {
return $this->query($args)->fetch(); return $this->query($args)->fetch();
} }
@@ -604,7 +605,7 @@ class Connection implements IConnection
* @return Row[]|array[] * @return Row[]|array[]
* @throws Exception * @throws Exception
*/ */
public function fetchAll(mixed ...$args): array public function fetchAll(#[Language('GenericSQL')] mixed ...$args): array
{ {
return $this->query($args)->fetchAll(); return $this->query($args)->fetchAll();
} }
@@ -614,7 +615,7 @@ class Connection implements IConnection
* Executes SQL query and fetch first column - shortcut for query() & fetchSingle(). * Executes SQL query and fetch first column - shortcut for query() & fetchSingle().
* @throws Exception * @throws Exception
*/ */
public function fetchSingle(mixed ...$args): mixed public function fetchSingle(#[Language('GenericSQL')] mixed ...$args): mixed
{ {
return $this->query($args)->fetchSingle(); return $this->query($args)->fetchSingle();
} }
@@ -624,7 +625,7 @@ class Connection implements IConnection
* Executes SQL query and fetch pairs - shortcut for query() & fetchPairs(). * Executes SQL query and fetch pairs - shortcut for query() & fetchPairs().
* @throws Exception * @throws Exception
*/ */
public function fetchPairs(mixed ...$args): array public function fetchPairs(#[Language('GenericSQL')] mixed ...$args): array
{ {
return $this->query($args)->fetchPairs(); return $this->query($args)->fetchPairs();
} }