Document breaking changes about serverVersion

[greg0ire]

No description provided.

[bohanyang]

On 4.0, is it necessary to use MariaDBPlatform instead of MySQL(80)Platform?
If yes, we should have a way to manually specify it to avoid unnecessary connections.

Maybe we should document and test the format like 10.9.3-MariaDB, which works against the new cleaned-up code.

Otherwise, MariaDB users have no idea how to explicitly specify it.

[greg0ire]

On 4.0, is it necessary to use MariaDBPlatform instead of MySQL(80)Platform?

Dunno. Where did you get that idea from?

Maybe we should document and test the format like 10.9.3-MariaDB, which works against the new cleaned-up code.

I think it's a good idea. What are users typically using before? mariadb-10.9.3?

[bohanyang]

Dunno. Where did you get that idea from?

Seems that MariaDBPlatform should be selected when using MariaDB otherwise issues like this will happen:
doctrine/DoctrineMigrationsBundle#337 (comment)

I think it's a good idea. What are users typically using before? mariadb-10.9.3?

Sure, as it's suggested by the official doc.

[greg0ire]

Seems that MariaDBPlatform should be selected when using MariaDB otherwise issues like this will happen:
doctrine/DoctrineMigrationsBundle#337 (comment)

@bohanyang I'm not following you, please clarify what you mean and how it relates to this.

[bohanyang]

What I mean is that should we change this paragraph to something like the following rather than completely removing it:

The value of `serverVersion` option should be a complete and valid version string, just like the response to a query of database version.

For example when using MySQL or MariaDB, it should be what returned by `SELECT VERSION();`,
like '10.9.3-MariaDB-1:10.9.3+maria~ubu2204'

[greg0ire]

🤔 if we add this to the docs, we should add it to 3.6.x IMO, or even on 3.5.x.

[derrabus]

Agreed, let's change the docs on 3.5.x already.

[derrabus]

Shouldn't a version string like 10.9.3-MariaDB be sufficient?

[bohanyang]

Shouldn't a version string like 10.9.3-MariaDB be sufficient?

Yes