feat: whereNotInArray support

Author: tyabu12

src/Query/Builder.php

@@ -163,19 +163,31 @@ public function whereIn($column, $values, $boolean = 'and', $not = false)
      * @param string $column
      * @param mixed $value
      * @param string $boolean
+     * @param bool $not
      * @return $this
      */
-    public function whereInArray(string $column, $value, string $boolean = 'and')
+    public function whereInArray(string $column, $value, string $boolean = 'and', bool $not = false)
     {
         $type = 'InArray';
 
-        $this->wheres[] = compact('type', 'column', 'value', 'boolean');
+        $this->wheres[] = compact('type', 'column', 'value', 'boolean', 'not');
 
         $this->addBinding($value);
 
         return $this;
     }
 
+    /**
+     * @param string $column
+     * @param mixed $value
+     * @param string $boolean
+     * @return $this
+     */
+    public function whereNotInArray(string $column, mixed $value, string $boolean = 'and'): static
+    {
+        return $this->whereInArray($column, $value, $boolean, true);
+    }
+
     /**
      * @param string|Expression $column
      * @param array<int, mixed>|Arrayable<int, mixed> $values

src/Query/Grammar.php

@@ -127,7 +127,9 @@ protected function compileIndexHint(Builder $query, $indexHint)
      */
     protected function whereInArray(Builder $query, $where)
     {
-        return '? in unnest(' . $this->wrap($where['column']) . ')';
+        return '?'
+            . ($where['not'] ? ' not' : '')
+            . ' in unnest(' . $this->wrap($where['column']) . ')';
     }
 
     /**

tests/Query/SpannerArrayTest.php

@@ -58,21 +58,53 @@ public function testSearchInArray(): void
         $qb = $conn->table($tableName);
         $qb->insert($insertValues);
 
-        $qb = $conn->table($tableName);
-        $result = $qb->whereInArray('int64Array', 0)->get();
-        $this->assertCount(1, $result);
+        $qb = $conn->table($tableName)->whereInArray('int64Array', 0);
+        $this->assertSame("select * from `{$tableName}` where ? in unnest(`int64Array`)", $qb->toSql());
+        $this->assertCount(1, $qb->get());
 
-        $qb = $conn->table($tableName);
-        $result = $qb->whereInArray('int64Array', 1)->get();
-        $this->assertCount(2, $result);
+        $qb = $conn->table($tableName)->whereInArray('int64Array', 1);
+        $this->assertSame("select * from `{$tableName}` where ? in unnest(`int64Array`)", $qb->toSql());
+        $this->assertCount(2, $qb->get());
 
-        $qb = $conn->table($tableName);
-        $result = $qb->whereInArray('int64Array', 2)->get();
-        $this->assertCount(3, $result);
+        $qb = $conn->table($tableName)->whereInArray('int64Array', 2);
+        $this->assertSame("select * from `{$tableName}` where ? in unnest(`int64Array`)", $qb->toSql());
+        $this->assertCount(3, $qb->get());
 
+        $qb = $conn->table($tableName)->whereInArray('int64Array', 300);
+        $this->assertSame("select * from `{$tableName}` where ? in unnest(`int64Array`)", $qb->toSql());
+        $this->assertCount(0, $qb->get());
+    }
+
+    public function testSearchNotInArray(): void
+    {
+        $conn = $this->getDefaultConnection();
+        $tableName = self::TABLE_NAME_ARRAY_TEST;
+
+        $testDataCount = 10;
+        $insertValues = [];
+        for ($i = 0; $i < $testDataCount; $i++) {
+            $row = $this->generateArrayTestRow();
+            $row['int64Array'] = [$i, $i + 1, $i + 2];
+            $insertValues[] = $row;
+        }
         $qb = $conn->table($tableName);
-        $result = $qb->whereInArray('int64Array', 300)->get();
-        $this->assertCount(0, $result);
+        $qb->insert($insertValues);
+
+        $qb = $conn->table($tableName)->whereNotInArray('int64Array', 0);
+        $this->assertSame("select * from `{$tableName}` where ? not in unnest(`int64Array`)", $qb->toSql());
+        $this->assertCount(9, $qb->get());
+
+        $qb = $conn->table($tableName)->whereNotInArray('int64Array', 1);
+        $this->assertSame("select * from `{$tableName}` where ? not in unnest(`int64Array`)", $qb->toSql());
+        $this->assertCount(8, $qb->get());
+
+        $qb = $conn->table($tableName)->whereNotInArray('int64Array', 2);
+        $this->assertSame("select * from `{$tableName}` where ? not in unnest(`int64Array`)", $qb->toSql());
+        $this->assertCount(7, $qb->get());
+
+        $qb = $conn->table($tableName)->whereNotInArray('int64Array', 300);
+        $this->assertSame("select * from `{$tableName}` where ? not in unnest(`int64Array`)", $qb->toSql());
+        $this->assertCount(10, $qb->get());
     }
 
     public function testUpdateArray(): void