Add Release 1.26.410 changelog, sync docs with readWithParams()

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: isublimity

CHANGELOG.md

@@ -2,6 +2,26 @@ PHP ClickHouse wrapper - Changelog
 
 ======================
 
+### 2026-04-10 [Release 1.26.410]
+
+#### New Features
+
+* **`readWithParams()`** (#254) — stream query results with native ClickHouse typed parameters (`{name:Type}` syntax), combining server-side parameter binding with streaming output (@sander-hash)
+
+#### Code Quality
+
+* **Stringable interfaces** (#252) — all Type classes now explicitly implement `Stringable` for consistency (@sander-hash)
+* **PHPStan test fixes** (#253) — removed redundant assertions in static tests, improved assertion quality (@sander-hash)
+* **Documentation sync** — updated GitHub Pages (docs/) with `readWithParams()` in native-params, streaming, and per-query-settings guides
+
+#### Merged PRs
+
+* #252 — Add Stringable interfaces for types (@sander-hash)
+* #253 — Fix phpstan errors in test files (@sander-hash)
+* #254 — Added native params for read function (@sander-hash)
+
+---
+
 ### 2026-04-06 [Release 1.24.406]
 
 #### New Features

doc/per-query-settings.md

@@ -37,6 +37,9 @@ $db->selectWithParams($sql, $params, $querySettings);
 
 // writeWithParams()
 $db->writeWithParams($sql, $params, $exception, $querySettings);
+
+// readWithParams()
+$db->readWithParams($streamRead, $sql, $params, $querySettings);
 ```
 
 ## Examples

docs/native-params.md

@@ -78,9 +78,33 @@ $db->selectWithParams(
 );
 ```
 
+## Streaming with Native Parameters
+
+Use `readWithParams()` to stream query results while still using server-side typed parameters:
+
+```php
+$stream = fopen('php://memory', 'r+');
+$streamRead = new ClickHouseDB\Transport\StreamRead($stream);
+
+$db->readWithParams(
+    $streamRead,
+    'SELECT id, name FROM users WHERE id = {id:UInt32} FORMAT JSONEachRow',
+    ['id' => 1]
+);
+
+rewind($stream);
+while (($line = fgets($stream)) !== false) {
+    $row = json_decode(trim($line), true);
+    echo $row['name'];
+}
+fclose($stream);
+```
+
+The FORMAT clause must be included in the SQL string — unlike `selectWithParams()`, no default format is applied.
+
 ## Per-Query Settings
 
-Both methods accept optional settings override:
+All three methods accept an optional settings override:
 
 ```php
 $result = $db->selectWithParams(
@@ -95,6 +119,14 @@ $db->writeWithParams(
     true,
     ['async_insert' => 1, 'wait_for_async_insert' => 0]
 );
+
+$stream = fopen('php://memory', 'r+');
+$db->readWithParams(
+    new ClickHouseDB\Transport\StreamRead($stream),
+    'SELECT id FROM t WHERE id = {id:UInt32} FORMAT JSONEachRow',
+    ['id' => 1],
+    ['max_execution_time' => 300]
+);
 ```
 
 ## Native Params vs Bindings
@@ -104,7 +136,7 @@ $db->writeWithParams(
 | SQL injection protection | Server-side (protocol level) | Client-side (escaping) |
 | Type validation | Server validates types | No validation |
 | Syntax | `{name:Type}` in SQL | `:name` or `{name}` in SQL |
-| Method | `selectWithParams()` | `select()` |
+| Method | `selectWithParams()`, `writeWithParams()`, `readWithParams()` | `select()` |
 | Large values | Passed in URL params | Embedded in SQL body |
 
 **Recommendation:** Use native parameters for new code. They are safer and let the server handle type conversion.

docs/per-query-settings.md

@@ -44,6 +44,9 @@ $db->selectWithParams($sql, $params, $querySettings);
 
 // writeWithParams()
 $db->writeWithParams($sql, $params, $exception, $querySettings);
+
+// readWithParams()
+$db->readWithParams($streamRead, $sql, $params, $querySettings);
 ```
 
 ## Examples

docs/streaming.md

@@ -95,6 +95,30 @@ $r = $client->streamRead(
 );
 ```
 
+## readWithParams
+
+Stream query results using native ClickHouse typed parameters (`{name:Type}` syntax). Combines the safety of server-side parameter binding with streaming output:
+
+```php
+$stream = fopen('php://memory', 'r+');
+$streamRead = new ClickHouseDB\Transport\StreamRead($stream);
+
+$client->readWithParams(
+    $streamRead,
+    'SELECT id, name FROM users WHERE id = {id:UInt32} FORMAT JSONEachRow',
+    ['id' => 1]
+);
+
+rewind($stream);
+while (($line = fgets($stream)) !== false) {
+    $row = json_decode(trim($line), true);
+    echo $row['name'];
+}
+fclose($stream);
+```
+
+The FORMAT clause must be specified in the SQL. See [native-params](native-params) for supported parameter types.
+
 ## Direct write to file
 
 Send ClickHouse results directly to a file without JSON parsing: