feat: extend database logger context

[lotyp]

Changes

• Introduced additional options in DriverConfig for detailed logging control: logInterpolatedQueries. Converts query into interpolated one. (Before change, this was done using logQueryParameters)

• logQueryParameters - Now, does, what variable name says — Logs query parameters as array

• Modified statement method in Driver.php to utilize new logging options, enriching log context with driver details and query parameters.

Rationale

These changes aim to improve the ORM's debugging and monitoring capabilities by offering detailed and configurable logging insights.

Checklist

• Closes # -
• How was this tested:

  • Added new tests to cover context parameters and driver

  • Created example application with sample entity, fired persist to get logger output, which now looks like this:

    • When logInterpolatedQueries => true and logQueryParameters' => true:

      [2024-03-19 21:42:14] local.INFO: INSERT INTO "posts" ("title", "content", "views", "id") VALUES ('title', 'content', 123, '018e58aa-38f9-725a-92cd-e69309ac5424') {"driver":"SQLite","elapsed":0.0006749629974365234,"rowCount":1,"parameters":["'title'","'content'","123","'018e58aa-38f9-725a-92cd-e69309ac5424'"]}
    

  • When logInterpolatedQueries => false and logQueryParameters' => true:

      [2024-03-19 21:52:20] local.INFO: INSERT INTO "posts" ("title", "content", "views", "id") VALUES (?, ?, ?, ?) {"driver":"SQLite","elapsed":0.0006299018859863281,"rowCount":1,"parameters":["'title'","'content'","123","'018e58b3-7727-7185-9b1a-b8993069a367'"]}
    

  • Default behavior (both parameters set to false):

      [2024-03-19 21:54:17] local.INFO: INSERT INTO "posts" ("title", "content", "views", "id") VALUES (?, ?, ?, ?) {"driver":"SQLite","elapsed":0.0006580352783203125,"rowCount":1}
    

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.24%. Comparing base (331a168) to head (1332047).

Additional details and impacted files

@@             Coverage Diff              @@
##                2.x     #165      +/-   ##
============================================
+ Coverage     95.23%   95.24%   +0.01%     
- Complexity     1833     1836       +3     
============================================
  Files           130      130              
  Lines          5054     5066      +12     
============================================
+ Hits           4813     4825      +12     
  Misses          241      241              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[roxblnfk]

LGTM