Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Made some platform class names reflect the lowest server version they support #3912

Merged
merged 3 commits into from
Mar 20, 2020

Conversation

morozov
Copy link
Member

@morozov morozov commented Mar 20, 2020

Q A
Type improvement
BC Break no †

The PostgreSqlPlatform, SQLAnywherePlatform and SQLServerPlatform classes have been renamed to PostgreSQL94Platform, SQLAnywhere16Platform and SQLServer2012Platform respectively.

This way, when deprecating an old platform version, we can deprecate and later remove a specific class. Otherwise, there's no way to express the deprecation on the class level and the upgrade notes contain sentences like: "XYZPlatform and XYZKeywords now represent XYZ (version)".

I deliberately didn't rename MySqlPlatform since there's no clear understanding of which MySQL version it corresponds to. We can remove it when we drop the support for MySQL 5.6.

Additionally, some leftovers of the platform and keyword class are removed (somehow they survived the backport in #3906).

† Despite the fact that the class names are being changed, such classes exist in 2.x and have the same API and purpose.

UPGRADE.md Outdated Show resolved Hide resolved
… support

The `PostgreSqlPlatform`, `SQLAnywherePlatform` and `SQLServerPlatform` classes have been renamed to `PostgreSQL94Platform`, `SQLAnywhere16Platform` and `SQLServer2012Platform` respectively.

When deprecating an old platform version, we can deprecate and later remove a specific class. Otherwise, there's no way to express the deprecation on the class level and the upgrade notes contain sentences like: "`XYZPlatform` and `XYZKeywords` now represent XYZ (version)".
@greg0ire greg0ire merged commit 40cc9bd into doctrine:3.0.x Mar 20, 2020
@greg0ire greg0ire self-assigned this Mar 20, 2020
@greg0ire
Copy link
Member

Thanks @morozov !

@morozov morozov deleted the versioned-platform-classes branch March 20, 2020 18:30
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Aug 4, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants