1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
<?php
namespace Drupal\Core\Extension;
/**
* Provides an extension version value object.
*
* @internal
*
* @see https://www.drupal.org/drupalorg/docs/apis/update-status-xml
*/
final class ExtensionVersion {
/**
* The '8.x-' prefix is used on contrib extension version numbers.
*
* @var string
*/
const CORE_PREFIX = '8.x-';
/**
* The major version.
*
* @var string
*/
protected $majorVersion;
/**
* The minor version.
*
* @var string|null
*/
protected $minorVersion;
/**
* The version extra string.
*
* For example, if the extension version is '2.0.3-alpha1', then the version
* extra string is 'alpha1'.
*
* @var string|null
*/
protected $versionExtra;
/**
* Constructs an extension version object from a version string.
*
* @param string $version_string
* The version string.
*
* @return \Drupal\Core\Extension\ExtensionVersion
* The extension version instance.
*/
public static function createFromVersionString(string $version_string): ExtensionVersion {
$original_version = $version_string;
if (str_starts_with($version_string, static::CORE_PREFIX) && $version_string !== '8.x-dev') {
$version_string = preg_replace('/8\.x-/', '', $version_string, 1);
}
else {
// Ensure the version string has no unsupported core prefixes.
$dot_x_position = strpos($version_string, '.x-');
if ($dot_x_position === 1 || $dot_x_position === 2) {
$after_core_prefix = explode('.x-', $version_string)[1];
if ($after_core_prefix !== 'dev') {
throw new \UnexpectedValueException("Unexpected version core prefix in $version_string. The only core prefix expected in \Drupal\Core\Extension\ExtensionVersion is: 8.x-");
}
}
}
$version_parts = explode('.', $version_string);
$major_version = $version_parts[0];
$version_parts_count = count($version_parts);
if ($version_parts_count === 2) {
$minor_version = NULL;
}
elseif ($version_parts_count === 3) {
$minor_version = $version_parts[1];
}
$last_part_split = explode('-', $version_parts[count($version_parts) - 1]);
$version_extra = count($last_part_split) === 1 ? NULL : $last_part_split[1];
if ($version_parts_count > 3
|| $version_parts_count < 2
|| !is_numeric($major_version)
|| ($version_parts_count === 3 && !is_numeric($version_parts[1]))
// The only case where a non-numeric version part other the extra part is
// allowed is in development versions like 8.x-1.x-dev, 1.2.x-dev or
// 1.x-dev.
|| (!is_numeric($last_part_split[0]) && $last_part_split !== 'x' && $version_extra !== 'dev')) {
throw new \UnexpectedValueException("Unexpected version number in: $original_version");
}
return new static($major_version, $minor_version, $version_extra);
}
/**
* Constructs an ExtensionVersion object.
*
* @param string $major_version
* The major version.
* @param string|null $minor_version
* The minor version.
* @param string|null $version_extra
* The extra version string.
*/
private function __construct(string $major_version, ?string $minor_version, ?string $version_extra) {
$this->majorVersion = $major_version;
$this->minorVersion = $minor_version;
$this->versionExtra = $version_extra;
}
/**
* Constructs an ExtensionVersion version object from a support branch.
*
* This can be used to determine the major version of the branch.
* ::getVersionExtra() will always return NULL for branches.
*
* @param string $branch
* The support branch.
*
* @return \Drupal\Core\Extension\ExtensionVersion
* The ExtensionVersion instance.
*/
public static function createFromSupportBranch(string $branch): ExtensionVersion {
if (!str_ends_with($branch, '.')) {
throw new \UnexpectedValueException("Invalid support branch: $branch");
}
return static::createFromVersionString($branch . '0');
}
/**
* Gets the major version.
*
* @return string
* The major version.
*/
public function getMajorVersion(): string {
return $this->majorVersion;
}
/**
* Gets the minor version.
*
* @return string|null
* The minor version.
*/
public function getMinorVersion(): ?string {
return $this->minorVersion;
}
/**
* Gets the version extra string at the end of the version number.
*
* @return string|null
* The version extra string if available, or otherwise NULL.
*/
public function getVersionExtra(): ?string {
return $this->versionExtra;
}
}
|
