feat(oracle): NVL2 function

Author: nxtpge

README.md

@@ -14,7 +14,7 @@ MySQL, Oracle, PostgreSQL and SQLite.
 | DB | Functions |
 |:--:|:---------:|
 | MySQL | `ACOS, ADDTIME, AES_DECRYPT, AES_ENCRYPT, ANY_VALUE, ASCII, ASIN, ATAN, ATAN2, BINARY, BIT_COUNT, BIT_XOR, CAST, CEIL, CHAR_LENGTH, COLLATE, CONCAT_WS, CONVERT_TZ, COS, COT, COUNTIF, CRC32, DATE, DATE_FORMAT, DATEADD, DATEDIFF, DATESUB, DAY, DAYNAME, DAYOFWEEK, DAYOFYEAR, DEGREES, DIV, EXP, EXTRACT, FIELD, FIND_IN_SET, FLOOR, FORMAT, FROM_BASE64, FROM_UNIXTIME, GREATEST, GROUP_CONCAT, HEX, HOUR, IFELSE, IFNULL, INET_ATON, INET_NTOA, INET6_ATON, INET6_NTOA, INSTR, IS_IPV4, IS_IPV4_COMPAT, IS_IPV4_MAPPED, IS_IPV6, JSON_CONTAINS, JSON_DEPTH, JSON_LENGTH, LAG, LAST_DAY, LEAD, LEAST, LOG, LOG10, LOG2, LPAD, MAKEDATE, MATCH, MD5, MINUTE, MONTH, MONTHNAME, NOW, NULLIF, OVER, PERIOD_DIFF, PI, POWER, QUARTER, RADIANS, RAND, REGEXP, REPLACE, ROUND, RPAD, SECOND, SECTOTIME, SHA1, SHA2, SIN, SOUNDEX, STD, STDDEV, STRTODATE, STR_TO_DATE, SUBSTRING_INDEX, TAN, TIME, TIMEDIFF, TIMESTAMPADD, TIMESTAMPDIFF, TIMETOSEC, TRUNCATE, UNHEX, UNIX_TIMESTAMP, UTC_TIMESTAMP, UUID_SHORT, VARIANCE, WEEK, WEEKDAY, WEEKOFYEAR, YEAR, YEARMONTH, YEARWEEK` |
-| Oracle | `CEIL, DAY, FLOOR, HOUR, LISTAGG, MINUTE, MONTH, NVL, SECOND, TO_CHAR, TO_DATE, TRUNC, YEAR` |
+| Oracle | `CEIL, DAY, FLOOR, HOUR, LISTAGG, MINUTE, MONTH, NVL, NVL2, SECOND, TO_CHAR, TO_DATE, TRUNC, YEAR` |
 | SQLite | `CASE WHEN THEN ELSE END, DATE, DATE_FORMAT*, DAY, HOUR, IFNULL, JULIANDAY, MINUTE, MONTH, REPLACE, ROUND, SECOND, STRFTIME, WEEK, WEEKDAY, YEAR` |
 | PostgreSQL | `AT_TIME_ZONE, COUNT_FILTER, DATE, DATE_PART, DATE_TRUNC, DAY, EXTRACT, GREATEST, HOUR, LEAST, MINUTE, MONTH, REGEXP_REPLACE, SECOND, STRING_AGG, TO_CHAR, TO_DATE, YEAR` |
 
@@ -39,7 +39,7 @@ If you want to run phpunit:
 composer run test
 ```
 
-If you want to run php-cs-fixer:
+If you want to run PHP_CodeSniffer and PHPStan:
 
 ```sh
 composer run lint

composer.json

@@ -38,6 +38,10 @@
         }
     },
     "scripts": {
+        "lint": [
+            "vendor/bin/phpcs -q --report=diff",
+            "vendor/bin/phpstan analyse src tests -v"
+        ],
         "test": "phpunit --colors=always"
     }
 }

config/oracle.yml

@@ -13,6 +13,7 @@ doctrine:
 
             string_functions:
                 nvl: DoctrineExtensions\Query\Oracle\Nvl
+                nvl2: DoctrineExtensions\Query\Oracle\Nvl2
                 listagg: DoctrineExtensions\Query\Oracle\Listagg
                 to_date: DoctrineExtensions\Query\Oracle\ToDate
 

src/Query/Oracle/Nvl2.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace DoctrineExtensions\Query\Oracle;
+
+use Doctrine\ORM\Query\AST\ArithmeticExpression;
+use Doctrine\ORM\Query\AST\Functions\FunctionNode;
+use Doctrine\ORM\Query\Parser;
+use Doctrine\ORM\Query\SqlWalker;
+use Doctrine\ORM\Query\TokenType;
+
+use function sprintf;
+
+/** @author https://github.com/nxtpge */
+class Nvl2 extends FunctionNode
+{
+    private ArithmeticExpression $expr1;
+
+    private ArithmeticExpression $expr2;
+
+    private ArithmeticExpression $expr3;
+
+    public function getSql(SqlWalker $sqlWalker): string
+    {
+        return sprintf(
+            'NVL2(%s, %s, %s)',
+            $sqlWalker->walkArithmeticExpression($this->expr1),
+            $sqlWalker->walkArithmeticExpression($this->expr2),
+            $sqlWalker->walkArithmeticExpression($this->expr3),
+        );
+    }
+
+    public function parse(Parser $parser): void
+    {
+        $parser->match(TokenType::T_IDENTIFIER);
+        $parser->match(TokenType::T_OPEN_PARENTHESIS);
+        $this->expr1 = $parser->ArithmeticExpression();
+        $parser->match(TokenType::T_COMMA);
+        $this->expr2 = $parser->ArithmeticExpression();
+        $parser->match(TokenType::T_COMMA);
+        $this->expr3 = $parser->ArithmeticExpression();
+        $parser->match(TokenType::T_CLOSE_PARENTHESIS);
+    }
+}

tests/Query/Oracle/Nvl2Test.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace DoctrineExtensions\Tests\Query\Oracle;
+
+use DoctrineExtensions\Tests\Query\OracleTestCase;
+
+/** @author https://github.com/nxtpge */
+class Nvl2Test extends OracleTestCase
+{
+    public function testNvl2(): void
+    {
+        $this->assertDqlProducesSql(
+            'SELECT NVL2(p.name, \'expr1\', \'expr2\') FROM DoctrineExtensions\Tests\Entities\Product p',
+            'SELECT NVL2(p0_.name, \'expr1\', \'expr2\') AS sclr_0 FROM Product p0_'
+        );
+    }
+}