Skip to content

Commit

Permalink
Update CHANGELOG and README
Browse files Browse the repository at this point in the history
  • Loading branch information
acoulton committed Oct 28, 2022
1 parent bdb444f commit 0a1ea52
Show file tree
Hide file tree
Showing 2 changed files with 23 additions and 4 deletions.
18 changes: 17 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,22 @@
### Unreleased

* Update doctrine/dbal to v3
## v2.0.0 (2022-10-28)

* [BREAKING] Update doctrine/dbal to v3
- This is a major release that introduces a number of breaking changes and deprecations - see the full upgrade notes
at https://github.com/doctrine/dbal/blob/3.5.x/UPGRADE.md

- Due to changes in the DBAL driver structure, `DoctrineFactory::getRawPDO` and the `doctrine.pdo_connection` service
now return an **actual** native PDO object, rather than a doctrine-specific wrapper/extension class. The major
difference will be that any calls will now throw native PDOException rather than doctrine exceptions. This should
not affect actual calling code (which presumably expects a `PDOException` if it is calling methods on a `PDO`).
However, things like loggers and global exception handlers will now potentially get two different classes of
database exceptions.

- The connection config returned when no database is configured (e.g. in an isolated unit-test environment) has
changed. We still use our NullPDO fake database connection, but this is now wrapped in a new FakeMysqlDriver class
as doctrine have split the driver and underlying PDO classes. NullPDO is now hardcoded to report that it is
connected to mysql 5.7.29.

## v1.4.0 (2022-10-14)

Expand Down
9 changes: 6 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,9 +47,12 @@ return [

Sometimes - e.g. for unit tests or running Doctrine build tooling - you might not have a database server actually
available. If you configure `'hostname' => NULL` we will use a `NullPDO` driver to allow Doctrine to bootstrap itself
without failing on a database connection error. That connection is sufficent to run things like `orm:generate-proxies`
or `orm:validate-schema --skip-sync`. If your code does anything that attempts to actually make PDO calls we'll throw
an exception.
without failing on a database connection error.

That connection is sufficent to run things like `orm:generate-proxies` or `orm:validate-schema --skip-sync`. You should
be aware that the NullPDO driver reports a mysql version of 5.7.29 - at time of writing doctrine/dbal does not vary any
SQL or column definitions between mysql 5.7.x and 8.x, so it shouldn't matter if this version differs from your runtime
mysql version. If your code does anything that attempts to actually make PDO calls we'll throw an exception.

## Configuring entities and options

Expand Down

0 comments on commit 0a1ea52

Please sign in to comment.