Skip to content

Latest commit

 

History

History
72 lines (45 loc) · 2.7 KB

UPGRADE.md

File metadata and controls

72 lines (45 loc) · 2.7 KB
Raw

Upgrade to 2.0

DBAL 3

The most significant change in version 2.0 is using doctrine/dbal 3. You should review their upgrade guide in addition to this one.

Lumen supported dropped

We recommend using eloquent instead.

Minimum Doctrine/ORM version to 2.14

This release supports a minimum doctrine/orm version of 2.14 due to a number of deprecations and new features that we are taking advantage of.

Proxy namespace required

You must now set a namespace for your proxies. Use the configuration option proxies.namespace. the previous default value was DoctrineProxies.

Command signature changed

All doctrine commands are now extended from doctrine itself. Some of the command options have been changed or removed, and some have been added.

Removed: FluentExporter, GenerateEntitiesCommand, GenerateRepositoriesCommand, ConvertMappingCommand, MappingImportCommand, ConvertConfigCommand

Doctrine is moving away from code generation and we are following suit, as well as reducing our maintenance burden.

Removed MasterSlaveConnection

The old MasterSlaveConnection has been supported for backwards compatibility, but has now been removed. You can migrate to the new PrimaryReadReplicaConnection instead.

Removed JSON type

If you were still including this line in your custom_types config, it should be removed:

'json' => LaravelDoctrine\ORM\Types\Json::class

Removed 'simple' Annotations

The simple configuration option for simple annotation reader has been removed as support for this is removed in Doctrine.

Short namespaces

Short namespaces such as Entities:User are no longer supported by Doctrine and have been removed.

Driver Options Rename

If you have been setting "driverOptions" on your MySQL database config, you should rename it to "options" to align with Laravel's naming scheme.

Metadata driver config removed

Used deprecated YamlDriver and was not supported by doctrine.

UrlRoutable::getRouteKeyName renamed to getRouteKeyNameStatic

This method was renamed to not conflict with the UrlRoutable trait of Laravel.

Logging configuration changed

DBAL deprecated the SQLLogger functionality in favor of the new middleware functionality. Logging moved to the new middlewares section.

  'middlewares' => [
    \Doctrine\DBAL\Logging\Middleware::class
  ],

Classes and interface in LaravelDoctrine\ORM\Loggers removed

Use new "middleware" logic, see above.

Clockwork logger removed

Out of scope for this package.

Laravel debugbar logger removed

Laravel debugbar does not support the new Middleware to Doctrine. Open for PR to re-add this functionality.