feat: add support for some new functions from PostgreSQL 18 (#464)

Author: martin-georgiev

docs/ARRAY-AND-JSON-FUNCTIONS.md

@@ -52,7 +52,9 @@ This document covers PostgreSQL array and JSON/JSONB operators and functions ava
 | array_prepend | ARRAY_PREPEND | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ArrayPrepend` |
 | array_remove | ARRAY_REMOVE | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ArrayRemove` |
 | array_replace | ARRAY_REPLACE | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ArrayReplace` |
+| array_reverse | ARRAY_REVERSE | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ArrayReverse` |
 | array_shuffle | ARRAY_SHUFFLE | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ArrayShuffle` |
+| array_sort | ARRAY_SORT | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ArraySort` |
 | array_to_json | ARRAY_TO_JSON | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ArrayToJson` |
 | array_to_string | ARRAY_TO_STRING | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ArrayToString` |
 | cardinality | ARRAY_CARDINALITY | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Cardinality` |

docs/AVAILABLE-FUNCTIONS-AND-OPERATORS.md

@@ -74,6 +74,7 @@ Complete documentation for PostgreSQL ltree (label tree) operations and hierarch
 - `ST_CONTAINS` - Test spatial containment
 
 **Text Operations:** ([Complete documentation](TEXT-AND-PATTERN-FUNCTIONS.md))
+- `CASEFOLD` - Advanced case-insensitive text comparison with Unicode support
 - `ILIKE` - Case-insensitive pattern matching
 - `REGEXP` (`~`) - Regular expression matching
 - `STARTS_WITH` - Test if text starts with substring
@@ -84,7 +85,9 @@ Complete documentation for PostgreSQL ltree (label tree) operations and hierarch
 - `DATERANGE` - Create date ranges
 
 **Mathematical Operations:** ([Complete documentation](MATHEMATICAL-FUNCTIONS.md))
+- `GAMMA` - Gamma function for statistical calculations
 - `GREATEST`/`LEAST` - Find maximum/minimum values
+- `LGAMMA` - Natural logarithm of gamma function
 - `ROUND` - Round numeric values
 - `RANDOM` - Generate random numbers
 
@@ -95,6 +98,13 @@ Complete documentation for PostgreSQL ltree (label tree) operations and hierarch
 - `INDEX` - Find position of ltree in another ltree
 - `LCA` - Find longest common ancestor
 
+**Utility Operations:**
+- `CRC32` - CRC-32 checksum computation
+- `CRC32C` - CRC-32C checksum computation
+- `REVERSE_BYTES` - Reverse byte order for bytea values
+- `UUIDV4` - Explicit UUID version 4 generation
+- `UUIDV7` - Generate timestamp-ordered UUIDs (version 7) for better database performance
+
 ## 📋 Summary of Available Function Categories
 
 ### **Array & JSON Functions**

docs/MATHEMATICAL-FUNCTIONS.md

@@ -13,8 +13,10 @@ This document covers PostgreSQL mathematical, utility, and miscellaneous functio
 | degrees | DEGREES | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Degrees` |
 | exp | EXP | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Exp` |
 | floor | FLOOR | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Floor` |
+| gamma | GAMMA | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Gamma` |
 | greatest | GREATEST | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Greatest` |
 | least | LEAST | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Least` |
+| lgamma | LGAMMA | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Lgamma` |
 | ln | LN | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Ln` |
 | log | LOG | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Log` |
 | pi | PI | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Pi` |
@@ -39,8 +41,13 @@ This document covers PostgreSQL mathematical, utility, and miscellaneous functio
 | PostgreSQL functions | Register for DQL as | Implemented by |
 |---|---|---|
 | any_value | ANY_VALUE | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\AnyValue` |
+| crc32 | CRC32 | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Crc32` |
+| crc32c | CRC32C | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Crc32c` |
+| reverse (bytea) | REVERSE_BYTES | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\ReverseBytes` |
 | row | ROW | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Row` |
 | row_to_json | ROW_TO_JSON | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\RowToJson` |
+| uuidv4 | UUIDV4 | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Uuidv4` |
+| uuidv7 | UUIDV7 | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Uuidv7` |
 | xmlagg | XML_AGG | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\XmlAgg` |
 
 ## Usage Examples

docs/TEXT-AND-PATTERN-FUNCTIONS.md

@@ -45,6 +45,7 @@ This document covers PostgreSQL text processing, pattern matching, and regular e
 
 | PostgreSQL functions | Register for DQL as | Implemented by |
 |---|---|---|
+| casefold | CASEFOLD | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Casefold` |
 | split_part | SPLIT_PART | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\SplitPart` |
 | starts_with | STARTS_WITH | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\StartsWith` |
 | string_agg | STRING_AGG | `MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\StringAgg` |

src/MartinGeorgiev/Doctrine/ORM/Query/AST/Functions/ArrayReverse.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MartinGeorgiev\Doctrine\ORM\Query\AST\Functions;
+
+/**
+ * Implementation of PostgreSQL ARRAY_REVERSE().
+ *
+ * @see https://www.postgresql.org/docs/18/functions-array.html
+ * @since 3.6
+ *
+ * @author Martin Georgiev <martin.georgiev@gmail.com>
+ */
+class ArrayReverse extends BaseFunction
+{
+    protected function customizeFunction(): void
+    {
+        $this->setFunctionPrototype('array_reverse(%s)');
+        $this->addNodeMapping('StringPrimary');
+    }
+}

src/MartinGeorgiev/Doctrine/ORM/Query/AST/Functions/ArraySort.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MartinGeorgiev\Doctrine\ORM\Query\AST\Functions;
+
+/**
+ * Implementation of PostgreSQL ARRAY_SORT().
+ *
+ * @see https://www.postgresql.org/docs/18/functions-array.html
+ * @since 3.6
+ *
+ * @author Martin Georgiev <martin.georgiev@gmail.com>
+ */
+class ArraySort extends BaseFunction
+{
+    protected function customizeFunction(): void
+    {
+        $this->setFunctionPrototype('array_sort(%s)');
+        $this->addNodeMapping('StringPrimary');
+    }
+}

src/MartinGeorgiev/Doctrine/ORM/Query/AST/Functions/Casefold.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MartinGeorgiev\Doctrine\ORM\Query\AST\Functions;
+
+/**
+ * Implementation of PostgreSQL CASEFOLD().
+ *
+ * @see https://www.postgresql.org/docs/18/functions-string.html
+ * @since 3.6
+ *
+ * @author Martin Georgiev <martin.georgiev@gmail.com>
+ */
+class Casefold extends BaseFunction
+{
+    protected function customizeFunction(): void
+    {
+        $this->setFunctionPrototype('casefold(%s)');
+        $this->addNodeMapping('StringPrimary');
+    }
+}

src/MartinGeorgiev/Doctrine/ORM/Query/AST/Functions/Crc32.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MartinGeorgiev\Doctrine\ORM\Query\AST\Functions;
+
+/**
+ * Implementation of PostgreSQL CRC32().
+ *
+ * @see https://www.postgresql.org/docs/18/functions-binarystring.html
+ * @since 3.6
+ *
+ * @author Martin Georgiev <martin.georgiev@gmail.com>
+ */
+class Crc32 extends BaseFunction
+{
+    protected function customizeFunction(): void
+    {
+        $this->setFunctionPrototype('crc32(%s::bytea)');
+        $this->addNodeMapping('StringPrimary');
+    }
+}

src/MartinGeorgiev/Doctrine/ORM/Query/AST/Functions/Crc32c.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MartinGeorgiev\Doctrine\ORM\Query\AST\Functions;
+
+/**
+ * Implementation of PostgreSQL CRC32C().
+ *
+ * @see https://www.postgresql.org/docs/18/functions-binarystring.html
+ * @since 3.6
+ *
+ * @author Martin Georgiev <martin.georgiev@gmail.com>
+ */
+class Crc32c extends BaseFunction
+{
+    protected function customizeFunction(): void
+    {
+        $this->setFunctionPrototype('crc32c(%s::bytea)');
+        $this->addNodeMapping('StringPrimary');
+    }
+}

src/MartinGeorgiev/Doctrine/ORM/Query/AST/Functions/Gamma.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MartinGeorgiev\Doctrine\ORM\Query\AST\Functions;
+
+/**
+ * Implementation of PostgreSQL GAMMA().
+ *
+ * @see https://www.postgresql.org/docs/18/functions-math.html
+ * @since 3.6
+ *
+ * @author Martin Georgiev <martin.georgiev@gmail.com>
+ */
+class Gamma extends BaseFunction
+{
+    protected function customizeFunction(): void
+    {
+        $this->setFunctionPrototype('gamma(%s)');
+        $this->addNodeMapping('ArithmeticPrimary');
+    }
+}