classServerVersion

packages/sql-fixture/src/Version/ServerVersion.php:16

final class ServerVersion

Public API: explicitly declared with @visibility public.

A supported database release, named by the version tag the sql-* packages share.

Resolve the default release of a dialectdoctest

\SqlFixture\Version\ServerVersion::resolve('mysql')->tag // => 'mysql-8.4.7'

Match the release a server reportsdoctest

\SqlFixture\Version\ServerVersion::fromServer('mysql', '8.0.36-0ubuntu0.22.04.1')->tag // => 'mysql-8.0.44'

Properties§

public string $dialect

source §

public string $tag

source §

public string $number

source §

Methods§

public function __construct(public string $dialect, public string $tag, public string $number)

source §

Parameters

`$dialect`	`string`	Dialect the release belongs to: `mysql`, `pgsql` or `sqlite`
`$tag`	`string`	Version tag such as `mysql-8.4.7`
`$number`	`string`	Release number such as `8.4.7`

public static function resolve(string $dialect, string|null $tag = null): self

source §

Resolves a version tag, the default of the dialect when none is given.

Parameters

`$dialect`	`string`	Dialect to look in
`$tag`	`string\|null`	Version tag such as `mysql-8.4.7`, or null for the default

Returns

self

Throws

UnsupportedVersionException When the dialect has no releases or the tag is not one of them

Test cases 8

Called from 2

Calls 5

new Releases line 40
method-call Releases::defaultTag() line 41
method-call Releases::numbers() line 42
new UnsupportedVersionException line 42
new self line 44

public static function fromServer(string $dialect, string $reported): self

source §

Matches the release closest to the version a server reports.

The release of the same series wins, where the series is every number but the last (8.0 for MySQL 8.0.36, 17 for PostgreSQL 17.2). Otherwise the newest release that is not newer than the server wins, and a server older than every release gets the oldest one.

Parameters

`$dialect`	`string`	Dialect of the server
`$reported`	`string`	Version string of the server, such as `8.0.36-0ubuntu0.22.04.1`

Returns

self

Throws

UnsupportedVersionException When the dialect has no releases or the string holds no version number

Test cases 2

Called from 1

static-call SqlFixture\Provider\PlatformFactory::detectVersion() packages/sql-fixture/src/Provider/PlatformFactory.php:171

Calls 7

static-call ReleaseNumber::fromReported() line 62
new UnsupportedVersionException line 62
static-call ServerVersion::all() line 63
function-call array_filter line 64
method-call self::series() line 64
function-call end line 66
method-call self::id() line 68

public static function all(string $dialect): non-empty-list<self>

source §

Lists the releases of a dialect, oldest first.

Parameters

$dialect string

Returns

non-empty-list<self>

Throws

UnsupportedVersionException When the dialect has no releases

Test cases 2

Called from 1

static-call SqlFixture\Version\ServerVersion::fromServer() packages/sql-fixture/src/Version/ServerVersion.php:63

Calls 3

public static function tags(string $dialect): non-empty-list<string>

source §

Lists the version tags of a dialect, oldest first.

Parameters

$dialect string

Returns

non-empty-list<string>

Throws

UnsupportedVersionException When the dialect has no releases

Test cases 1

ServerVersionTest::testTagsMatchTheOtherSqlPackages calls

Called from 1

static-call SqlFixture\Provider\PlatformFactory::getSupportedVersions() packages/sql-fixture/src/Provider/PlatformFactory.php:201

Calls 3

function-call array_keys line 99
method-call Releases::numbers() line 99
new Releases line 99

public function isDefault(): bool

source §

Reports whether this is the default release of its dialect.

Returns

bool

Test cases 1

ServerVersionTest::testIsDefaultMarksOneReleasePerDialect calls

Calls 2

method-call Releases::defaultTag() line 107
new Releases line 107

public function id(): int

source §

Numbers the release as MySQL numbers its own, as in MYSQL_VERSION_ID.

Returns

int Major times ten thousand plus minor times a hundred plus patch

Called from 1

method-call SqlFixture\Version\ServerVersion::isAtLeast() packages/sql-fixture/src/Version/ServerVersion.php:137

Calls 2

method-call ReleaseNumber::id() line 117
new ReleaseNumber line 117

public function series(): string

source §

Names the series of the release: every number but the last.

Returns

string `8.0` for `8.0.44`, `17` for `17.2`

Calls 2

method-call ReleaseNumber::series() line 127
new ReleaseNumber line 127

public function isAtLeast(string $number): bool

source §

Reports whether the release is the given number or newer.

Parameters

$number string Release number such as `5.7.8`

Returns

bool

Calls 3

method-call ServerVersion::id() line 137
method-call ReleaseNumber::id() line 137
new ReleaseNumber line 137

Test cases 17§

Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.

Dedicated tests 12

Other tests reaching this symbol 5

MySqlReleaseRoundTripTest::testRowGeneratedFromTheReportedSchemaIsAccepted calls
DatabaseFixtureProviderTest calls
FileFixtureProviderTest calls
FixtureProviderTest calls
PlatformFactoryTest calls

Relations§

Static calls 4

Type declarations 5