Add FOR clause for query (#354)

Author: vjik

CHANGELOG.md

@@ -36,6 +36,7 @@
 - Enh #347: Remove `getCacheKey()` and `getCacheTag()` methods from `Schema` class (@Tigrov)
 - Enh #350, #351: Use `DbArrayHelper::arrange()` instead of `DbArrayHelper::index()` method (@Tigrov)
 - New #348: Realize `Schema::loadResultColumn()` method (@Tigrov)
+- New #354: Add `FOR` clause to query (@vjik)
 
 ## 1.2.0 March 21, 2024
 

src/DQLQueryBuilder.php

@@ -4,6 +4,7 @@
 
 namespace Yiisoft\Db\Sqlite;
 
+use Yiisoft\Db\Exception\NotSupportedException;
 use Yiisoft\Db\Expression\ExpressionInterface;
 use Yiisoft\Db\Query\Query;
 use Yiisoft\Db\Query\QueryInterface;
@@ -38,6 +39,7 @@ public function build(QueryInterface $query, array $params = []): array
             $this->buildWhere($query->getWhere(), $params),
             $this->buildGroupBy($query->getGroupBy()),
             $this->buildHaving($query->getHaving(), $params),
+            $this->buildFor($query->getFor()),
         ];
 
         $orderBy = $query->getOrderBy();
@@ -77,6 +79,15 @@ public function build(QueryInterface $query, array $params = []): array
         return [$sql, $params];
     }
 
+    public function buildFor(array $values): string
+    {
+        if (empty($values)) {
+            return '';
+        }
+
+        throw new NotSupportedException('SQLite don\'t supports FOR clause.');
+    }
+
     public function buildLimit(ExpressionInterface|int|null $limit, ExpressionInterface|int|null $offset): string
     {
         $sql = '';