PDO according to 8.4 changes and feedbacks from @pmjones #231 (comment)

.gitignore

@@ -1,2 +1,3 @@
 composer.lock
 vendor/*
+.phpunit.result.cache

docs/getting-started.md

@@ -42,7 +42,7 @@ Whereas the native _PDO_ connects on instantiation, _ExtendedPdo_ does not
 connect immediately. Instead, it connects only when you call a method that
 actually needs the connection to the database; e.g., on `query()`.
 
-If you want to force a connection, call the `establishConnection()` method.
+If you want to force a connection, call the `lazyConnect()` method.
 
 ```php
 // does not connect to the database
@@ -56,7 +56,7 @@ $pdo = new ExtendedPdo(
 $pdo->exec('SELECT * FROM test');
 
 // explicitly forces a connection
-$pdo->establishConnection();
+$pdo->lazyConnect();
 ```
 
 If you want to explicitly force a disconnect, call the `disconnect()` method.

docs/upgrade.md

@@ -4,8 +4,8 @@ Most changes are to provide better compatability with PHP 8.4 and above.
 
 With PHP 8.4 introducing `Pdo::connect()` as a way of creating driver specific connections.
 
-We have introducing our `ExtendedPdo::connect()` which uses the underlining PDO features then with all our
-normal added features.
+`ExtendedPdo::connect()` will be still using only the PDO and not subclass feature.
+If you want to use the subclass feature use the `DecoratedPdo` passing the pdo instance directly.
 
 ```php
 // does not connect to the database
@@ -19,7 +19,7 @@ $pdo = ExtendedPdo::connect(
 $pdo->exec('SELECT * FROM test');
 
 // explicitly forces a connection
-$pdo->establishConnection();
+$pdo->lazyConnect();
 ```
 
 # 5.x Upgrade Notes
@@ -46,7 +46,7 @@ $pdo->exec('SELECT * FROM test');
 // explicitly forces a connection
 $pdo->connect();
 ```
-... and now needs to be changed to `ExtendedPdo::establishConnection()`
+... and now needs to be changed to `ExtendedPdo::lazyConnect()`
 
 ```php
 // does not connect to the database
@@ -60,7 +60,7 @@ $pdo = new ExtendedPdo(
 $pdo->exec('SELECT * FROM test');
 
 // explicitly forces a connection
-$pdo->establishConnection();
+$pdo->lazyConnect();
 ```
 
 # 3.x Upgrade Notes
@@ -298,4 +298,3 @@ underlying PDO instance to make those methods available, if they exist.
 
 - When dumping an ExtendedPdo object, the username and password are omitted. This
 should help keep unexpected output of stack traces from revealing credentials.
-