feat: add RawSql class

Author: kenjis

system/Database/RawSql.php

@@ -0,0 +1,49 @@
+<?php
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <admin@codeigniter.com>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\Database;
+
+class RawSql
+{
+    /**
+     * @var string Raw SQL string
+     */
+    private string $string;
+
+    public function __construct(string $sqlString)
+    {
+        $this->string = $sqlString;
+    }
+
+    public function __toString(): string
+    {
+        return $this->string;
+    }
+
+    /**
+     * Create new instance with new SQL string
+     */
+    public function with(string $newSqlString): self
+    {
+        $new         = clone $this;
+        $new->string = $newSqlString;
+
+        return $new;
+    }
+
+    /**
+     * Returns unique id for binding key
+     */
+    public function getBindingKey(): string
+    {
+        return 'RawSql' . spl_object_id($this);
+    }
+}

tests/system/Database/RawSqlTest.php

@@ -0,0 +1,50 @@
+<?php
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <admin@codeigniter.com>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\Database;
+
+use CodeIgniter\Test\CIUnitTestCase;
+
+/**
+ * @internal
+ */
+final class RawSqlTest extends CIUnitTestCase
+{
+    public function testCanConvertToString()
+    {
+        $expected = 'REGEXP_SUBSTR(ral_anno,"[0-9]{1,2}([,.][0-9]{1,3})([,.][0-9]{1,3})") AS ral';
+        $rawSql   = new RawSql($expected);
+
+        $this->assertSame($expected, (string) $rawSql);
+    }
+
+    public function testCanCreateNewObject()
+    {
+        $firstSql = 'a = 1 AND b = 2';
+        $rawSql   = new RawSql($firstSql);
+
+        $secondSql = 'a = 1 AND b = 2 OR c = 3';
+        $newRawSQL = $rawSql->with($secondSql);
+
+        $this->assertSame($firstSql, (string) $rawSql);
+        $this->assertSame($secondSql, (string) $newRawSQL);
+    }
+
+    public function testGetBindingKey()
+    {
+        $firstSql = 'a = 1 AND b = 2';
+        $rawSql   = new RawSql($firstSql);
+
+        $key = $rawSql->getBindingKey();
+
+        $this->assertMatchesRegularExpression('/\ARawSql[0-9]+\z/', $key);
+    }
+}