Allow for custom Postgres operators to be added (#53324)

* Allow for custom Postgres operators to be added

* formatting

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: boris-glumpler

src/Illuminate/Database/Query/Grammars/PostgresGrammar.php

@@ -22,6 +22,13 @@ class PostgresGrammar extends Grammar
         'is distinct from', 'is not distinct from',
     ];
 
+    /**
+     * The Postgres grammar specific custom operators.
+     *
+     * @var array
+     */
+    protected static $customOperators = [];
+
     /**
      * The grammar specific bitwise operators.
      *
@@ -772,4 +779,27 @@ public function substituteBindingsIntoRawSql($sql, $bindings)
 
         return $query;
     }
+
+    /**
+     * Get the Postgres grammar specific operators.
+     *
+     * @return array
+     */
+    public function getOperators()
+    {
+        return array_values(array_unique(array_merge(parent::getOperators(), static::$customOperators)));
+    }
+
+    /**
+     * Set any Postgres grammar specific custom operators.
+     *
+     * @param  array  $operators
+     * @return void
+     */
+    public static function customOperators(array $operators)
+    {
+        static::$customOperators = array_values(
+            array_merge(static::$customOperators, array_filter(array_filter($operators, 'is_string')))
+        );
+    }
 }

tests/Database/DatabasePostgresQueryGrammarTest.php

@@ -28,4 +28,23 @@ public function testToRawSql()
 
         $this->assertSame('select * from "users" where \'{}\' ? \'Hello\\\'\\\'World?\' AND "email" = \'foo\'', $query);
     }
+
+    public function testCustomOperators()
+    {
+        PostgresGrammar::customOperators(['@@@', '@>', '']);
+        PostgresGrammar::customOperators(['@@>', 1]);
+
+        $connection = m::mock(Connection::class);
+        $grammar = new PostgresGrammar;
+        $grammar->setConnection($connection);
+
+        $operators = $grammar->getOperators();
+
+        $this->assertIsList($operators);
+        $this->assertContains('@@@', $operators);
+        $this->assertContains('@@>', $operators);
+        $this->assertNotContains('', $operators);
+        $this->assertNotContains(1, $operators);
+        $this->assertSame(array_unique($operators), $operators);
+    }
 }