test(QueryBuilderMixin): add test for quoted raw sql handling in toRawSql

- Extend `replaceSqlBindings` function docblock with additional PHP functions for context.
- Add a new test to verify quoting and escaping of raw SQL in `toRawSql`.
 - Test deals with special characters, strings, numbers, nulls, and booleans.
 - Ensures expected SQL output is correctly formatted.
- Maintain grouping in the test file for better organization.

Author: guanguans

src/Support/Utils.php

@@ -94,6 +94,15 @@ public static function toRawSql(EloquentBuilder|QueryBuilder|QueryExecuted|Relat
      * @noinspection DebugFunctionUsageInspection
      *
      * @see \Laravel\Telescope\Watchers\QueryWatcher::replaceBindings()
+     * @see addslashes()
+     * @see addcslashes()
+     * @see stripslashes()
+     * @see stripcslashes()
+     * @see quotemeta()
+     * @see mysqli_real_escape_string()
+     * @see PDO::quote()
+     * @see var_export()
+     * @see json_encode()
      */
     public static function replaceSqlBindings(string $sql, array $bindings, Connection $connection): string
     {

tests/Mixins/QueryBuilderMixinTest.php

@@ -30,6 +30,37 @@
     ])->each->toBe('select * from "users" where "id" = 1 and "name" = \'soar\'');
 })->group(__DIR__, __FILE__);
 
+it('can return quoted raw sql for `toRawSql`', function (): void {
+    expect(User::query())
+        ->whereIn('name', $names = [
+            "O'Reilly",
+            'He said "Hello"',
+            'C:\\Users\\Admin',
+            '100%',
+            'user_name',
+            '`backtick`',
+            '$dollar$',
+            "line1\nline2",
+            'comma,semicolon;',
+            '特殊字符：★☆！@#',
+            null,
+            111100,
+            1.11100,
+            false,
+            true,
+        ])
+        ->toRawSql()
+        ->toBe(
+            $rawSql = <<<'SQL'
+                select * from "users" where "name" in ('O''Reilly', 'He said "Hello"', 'C:\Users\Admin', '100%', 'user_name', '`backtick`', '$dollar$', 'line1
+                line2', 'comma,semicolon;', '特殊字符：★☆！@#', NULL, 111100, 1.111, 0, 1)
+                SQL
+        );
+
+    User::query()->whereIn('name', $names)->first();
+    DB::scalar($rawSql);
+})->group(__DIR__, __FILE__);
+
 it('can dump raw sql for `dumpRawSql`', function (): void {
     expect(User::query()->where('id', 1)->where('name', 'soar')->dumpRawSql())->toBeInstanceOf(Builder::class);
 })->group(__DIR__, __FILE__);