PluginProbe
Yoast SEO – Advanced SEO with real-time guidance and built-in AI / trunk
Yoast SEO – Advanced SEO with real-time guidance and built-in AI vtrunk
28.5 28.4 28.3 28.2 28.1 28.0 27.9 27.8 27.7 27.6 27.5 trunk 18.0 18.1 18.2 18.3 18.4 18.4.1 18.5 18.5.1 18.6 18.7 18.8 18.9 19.0 All 129 releases
← All changes | vendor/composer/InstalledVersions.php +336 -271 18.7 → trunk View file →
@@ -1,331 +1,396 @@
1 1 <?php
2 2
3 +/*
4 + * This file is part of Composer.
5 + *
6 + * (c) Nils Adermann <[email protected]>
7 + * Jordi Boggiano <[email protected]>
8 + *
9 + * For the full copyright and license information, please view the LICENSE
10 + * file that was distributed with this source code.
11 + */
3 12
4 -
5 -
6 -
7 -
8 -
9 -
10 -
11 -
12 -
13 13 namespace Composer;
14 14
15 15 use Composer\Autoload\ClassLoader;
16 16 use Composer\Semver\VersionParser;
17 17
18 -
19 -
20 -
21 -
22 -
23 -
24 -
18 +/**
19 + * This class is copied in every Composer installed project and available to all
20 + *
21 + * See also https://getcomposer.org/doc/07-runtime.md#installed-versions
22 + *
23 + * To require its presence, you can require `composer-runtime-api ^2.0`
24 + *
25 + * @final
26 + */
25 27 class InstalledVersions
26 28 {
27 -private static $installed = array (
28 - 'root' =>
29 - array (
30 - 'pretty_version' => 'dev-master',
31 - 'version' => 'dev-master',
32 - 'aliases' =>
33 - array (
34 - ),
35 - 'reference' => '5e42d45bbaee74a4621ab1c0f80072ab8b769ba8',
36 - 'name' => 'yoast/wordpress-seo',
37 - ),
38 - 'versions' =>
39 - array (
40 - 'composer/installers' =>
41 - array (
42 - 'pretty_version' => 'v1.12.0',
43 - 'version' => '1.12.0.0',
44 - 'aliases' =>
45 - array (
46 - ),
47 - 'reference' => 'd20a64ed3c94748397ff5973488761b22f6d3f19',
48 - ),
49 - 'roundcube/plugin-installer' =>
50 - array (
51 - 'replaced' =>
52 - array (
53 - 0 => '*',
54 - ),
55 - ),
56 - 'shama/baton' =>
57 - array (
58 - 'replaced' =>
59 - array (
60 - 0 => '*',
61 - ),
62 - ),
63 - 'yoast/i18n-module' =>
64 - array (
65 - 'pretty_version' => '3.1.1',
66 - 'version' => '3.1.1.0',
67 - 'aliases' =>
68 - array (
69 - ),
70 - 'reference' => '9d0a2f6daea6fb42376b023e7778294d19edd85d',
71 - ),
72 - 'yoast/wordpress-seo' =>
73 - array (
74 - 'pretty_version' => 'dev-master',
75 - 'version' => 'dev-master',
76 - 'aliases' =>
77 - array (
78 - ),
79 - 'reference' => '5e42d45bbaee74a4621ab1c0f80072ab8b769ba8',
80 - ),
81 - ),
82 -);
83 -private static $canGetVendors;
84 -private static $installedByVendor = array();
29 + /**
30 + * @var string|null if set (by reflection by Composer), this should be set to the path where this class is being copied to
31 + * @internal
32 + */
33 + private static $selfDir = null;
85 34
35 + /**
36 + * @var mixed[]|null
37 + * @psalm-var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array<string, array{pretty_version?: string, version?: string, reference?: string|null, type?: string, install_path?: string, aliases?: string[], dev_requirement: bool, replaced?: string[], provided?: string[]}>}|array{}|null
38 + */
39 + private static $installed;
86 40
41 + /**
42 + * @var bool
43 + */
44 + private static $installedIsLocalDir;
87 45
46 + /**
47 + * @var bool|null
48 + */
49 + private static $canGetVendors;
88 50
51 + /**
52 + * @var array[]
53 + * @psalm-var array<string, array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array<string, array{pretty_version?: string, version?: string, reference?: string|null, type?: string, install_path?: string, aliases?: string[], dev_requirement: bool, replaced?: string[], provided?: string[]}>}>
54 + */
55 + private static $installedByVendor = array();
89 56
57 + /**
58 + * Returns a list of all package names which are present, either by being installed, replaced or provided
59 + *
60 + * @return string[]
61 + * @psalm-return list<string>
62 + */
63 + public static function getInstalledPackages()
64 + {
65 + $packages = array();
66 + foreach (self::getInstalled() as $installed) {
67 + $packages[] = array_keys($installed['versions']);
68 + }
90 69
70 + if (1 === \count($packages)) {
71 + return $packages[0];
72 + }
91 73
92 -public static function getInstalledPackages()
93 -{
94 -$packages = array();
95 -foreach (self::getInstalled() as $installed) {
96 -$packages[] = array_keys($installed['versions']);
97 -}
74 + return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
75 + }
98 76
99 -if (1 === \count($packages)) {
100 -return $packages[0];
101 -}
77 + /**
78 + * Returns a list of all package names with a specific type e.g. 'library'
79 + *
80 + * @param string $type
81 + * @return string[]
82 + * @psalm-return list<string>
83 + */
84 + public static function getInstalledPackagesByType($type)
85 + {
86 + $packagesByType = array();
102 87
103 -return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
104 -}
88 + foreach (self::getInstalled() as $installed) {
89 + foreach ($installed['versions'] as $name => $package) {
90 + if (isset($package['type']) && $package['type'] === $type) {
91 + $packagesByType[] = $name;
92 + }
93 + }
94 + }
105 95
96 + return $packagesByType;
97 + }
106 98
99 + /**
100 + * Checks whether the given package is installed
101 + *
102 + * This also returns true if the package name is provided or replaced by another package
103 + *
104 + * @param string $packageName
105 + * @param bool $includeDevRequirements
106 + * @return bool
107 + */
108 + public static function isInstalled($packageName, $includeDevRequirements = true)
109 + {
110 + foreach (self::getInstalled() as $installed) {
111 + if (isset($installed['versions'][$packageName])) {
112 + return $includeDevRequirements || !isset($installed['versions'][$packageName]['dev_requirement']) || $installed['versions'][$packageName]['dev_requirement'] === false;
113 + }
114 + }
107 115
116 + return false;
117 + }
108 118
119 + /**
120 + * Checks whether the given package satisfies a version constraint
121 + *
122 + * e.g. If you want to know whether version 2.3+ of package foo/bar is installed, you would call:
123 + *
124 + * Composer\InstalledVersions::satisfies(new VersionParser, 'foo/bar', '^2.3')
125 + *
126 + * @param VersionParser $parser Install composer/semver to have access to this class and functionality
127 + * @param string $packageName
128 + * @param string|null $constraint A version constraint to check for, if you pass one you have to make sure composer/semver is required by your package
129 + * @return bool
130 + */
131 + public static function satisfies(VersionParser $parser, $packageName, $constraint)
132 + {
133 + $constraint = $parser->parseConstraints((string) $constraint);
134 + $provided = $parser->parseConstraints(self::getVersionRanges($packageName));
109 135
136 + return $provided->matches($constraint);
137 + }
110 138
139 + /**
140 + * Returns a version constraint representing all the range(s) which are installed for a given package
141 + *
142 + * It is easier to use this via isInstalled() with the $constraint argument if you need to check
143 + * whether a given version of a package is installed, and not just whether it exists
144 + *
145 + * @param string $packageName
146 + * @return string Version constraint usable with composer/semver
147 + */
148 + public static function getVersionRanges($packageName)
149 + {
150 + foreach (self::getInstalled() as $installed) {
151 + if (!isset($installed['versions'][$packageName])) {
152 + continue;
153 + }
111 154
155 + $ranges = array();
156 + if (isset($installed['versions'][$packageName]['pretty_version'])) {
157 + $ranges[] = $installed['versions'][$packageName]['pretty_version'];
158 + }
159 + if (array_key_exists('aliases', $installed['versions'][$packageName])) {
160 + $ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']);
161 + }
162 + if (array_key_exists('replaced', $installed['versions'][$packageName])) {
163 + $ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']);
164 + }
165 + if (array_key_exists('provided', $installed['versions'][$packageName])) {
166 + $ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']);
167 + }
112 168
169 + return implode(' || ', $ranges);
170 + }
113 171
114 -public static function isInstalled($packageName)
115 -{
116 -foreach (self::getInstalled() as $installed) {
117 -if (isset($installed['versions'][$packageName])) {
118 -return true;
119 -}
120 -}
172 + throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
173 + }
121 174
122 -return false;
123 -}
175 + /**
176 + * @param string $packageName
177 + * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present
178 + */
179 + public static function getVersion($packageName)
180 + {
181 + foreach (self::getInstalled() as $installed) {
182 + if (!isset($installed['versions'][$packageName])) {
183 + continue;
184 + }
124 185
186 + if (!isset($installed['versions'][$packageName]['version'])) {
187 + return null;
188 + }
125 189
190 + return $installed['versions'][$packageName]['version'];
191 + }
126 192
193 + throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
194 + }
127 195
196 + /**
197 + * @param string $packageName
198 + * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present
199 + */
200 + public static function getPrettyVersion($packageName)
201 + {
202 + foreach (self::getInstalled() as $installed) {
203 + if (!isset($installed['versions'][$packageName])) {
204 + continue;
205 + }
128 206
207 + if (!isset($installed['versions'][$packageName]['pretty_version'])) {
208 + return null;
209 + }
129 210
211 + return $installed['versions'][$packageName]['pretty_version'];
212 + }
130 213
214 + throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
215 + }
131 216
217 + /**
218 + * @param string $packageName
219 + * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as reference
220 + */
221 + public static function getReference($packageName)
222 + {
223 + foreach (self::getInstalled() as $installed) {
224 + if (!isset($installed['versions'][$packageName])) {
225 + continue;
226 + }
132 227
228 + if (!isset($installed['versions'][$packageName]['reference'])) {
229 + return null;
230 + }
133 231
232 + return $installed['versions'][$packageName]['reference'];
233 + }
134 234
235 + throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
236 + }
135 237
238 + /**
239 + * @param string $packageName
240 + * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as install path. Packages of type metapackages also have a null install path.
241 + */
242 + public static function getInstallPath($packageName)
243 + {
244 + foreach (self::getInstalled() as $installed) {
245 + if (!isset($installed['versions'][$packageName])) {
246 + continue;
247 + }
136 248
249 + return isset($installed['versions'][$packageName]['install_path']) ? $installed['versions'][$packageName]['install_path'] : null;
250 + }
137 251
138 -public static function satisfies(VersionParser $parser, $packageName, $constraint)
139 -{
140 -$constraint = $parser->parseConstraints($constraint);
141 -$provided = $parser->parseConstraints(self::getVersionRanges($packageName));
252 + throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
253 + }
142 254
143 -return $provided->matches($constraint);
144 -}
255 + /**
256 + * @return array
257 + * @psalm-return array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}
258 + */
259 + public static function getRootPackage()
260 + {
261 + $installed = self::getInstalled();
145 262
263 + return $installed[0]['root'];
264 + }
146 265
266 + /**
267 + * Returns the raw installed.php data for custom implementations
268 + *
269 + * @deprecated Use getAllRawData() instead which returns all datasets for all autoloaders present in the process. getRawData only returns the first dataset loaded, which may not be what you expect.
270 + * @return array[]
271 + * @psalm-return array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array<string, array{pretty_version?: string, version?: string, reference?: string|null, type?: string, install_path?: string, aliases?: string[], dev_requirement: bool, replaced?: string[], provided?: string[]}>}
272 + */
273 + public static function getRawData()
274 + {
275 + @trigger_error('getRawData only returns the first dataset loaded, which may not be what you expect. Use getAllRawData() instead which returns all datasets for all autoloaders present in the process.', E_USER_DEPRECATED);
147 276
277 + if (null === self::$installed) {
278 + // only require the installed.php file if this file is loaded from its dumped location,
279 + // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
280 + if (substr(__DIR__, -8, 1) !== 'C') {
281 + self::$installed = include __DIR__ . '/installed.php';
282 + } else {
283 + self::$installed = array();
284 + }
285 + }
148 286
287 + return self::$installed;
288 + }
149 289
290 + /**
291 + * Returns the raw data of all installed.php which are currently loaded for custom implementations
292 + *
293 + * @return array[]
294 + * @psalm-return list<array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array<string, array{pretty_version?: string, version?: string, reference?: string|null, type?: string, install_path?: string, aliases?: string[], dev_requirement: bool, replaced?: string[], provided?: string[]}>}>
295 + */
296 + public static function getAllRawData()
297 + {
298 + return self::getInstalled();
299 + }
150 300
301 + /**
302 + * Lets you reload the static array from another file
303 + *
304 + * This is only useful for complex integrations in which a project needs to use
305 + * this class but then also needs to execute another project's autoloader in process,
306 + * and wants to ensure both projects have access to their version of installed.php.
307 + *
308 + * A typical case would be PHPUnit, where it would need to make sure it reads all
309 + * the data it needs from this class, then call reload() with
310 + * `require $CWD/vendor/composer/installed.php` (or similar) as input to make sure
311 + * the project in which it runs can then also use this class safely, without
312 + * interference between PHPUnit's dependencies and the project's dependencies.
313 + *
314 + * @param array[] $data A vendor/composer/installed.php data set
315 + * @return void
316 + *
317 + * @psalm-param array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array<string, array{pretty_version?: string, version?: string, reference?: string|null, type?: string, install_path?: string, aliases?: string[], dev_requirement: bool, replaced?: string[], provided?: string[]}>} $data
318 + */
319 + public static function reload($data)
320 + {
321 + self::$installed = $data;
322 + self::$installedByVendor = array();
151 323
324 + // when using reload, we disable the duplicate protection to ensure that self::$installed data is
325 + // always returned, but we cannot know whether it comes from the installed.php in __DIR__ or not,
326 + // so we have to assume it does not, and that may result in duplicate data being returned when listing
327 + // all installed packages for example
328 + self::$installedIsLocalDir = false;
329 + }
152 330
331 + /**
332 + * @return string
333 + */
334 + private static function getSelfDir()
335 + {
336 + if (self::$selfDir === null) {
337 + self::$selfDir = strtr(__DIR__, '\\', '/');
338 + }
153 339
340 + return self::$selfDir;
341 + }
154 342
155 -public static function getVersionRanges($packageName)
156 -{
157 -foreach (self::getInstalled() as $installed) {
158 -if (!isset($installed['versions'][$packageName])) {
159 -continue;
160 -}
343 + /**
344 + * @return array[]
345 + * @psalm-return list<array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array<string, array{pretty_version?: string, version?: string, reference?: string|null, type?: string, install_path?: string, aliases?: string[], dev_requirement: bool, replaced?: string[], provided?: string[]}>}>
346 + */
347 + private static function getInstalled()
348 + {
349 + if (null === self::$canGetVendors) {
350 + self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders');
351 + }
161 352
162 -$ranges = array();
163 -if (isset($installed['versions'][$packageName]['pretty_version'])) {
164 -$ranges[] = $installed['versions'][$packageName]['pretty_version'];
165 -}
166 -if (array_key_exists('aliases', $installed['versions'][$packageName])) {
167 -$ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']);
168 -}
169 -if (array_key_exists('replaced', $installed['versions'][$packageName])) {
170 -$ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']);
171 -}
172 -if (array_key_exists('provided', $installed['versions'][$packageName])) {
173 -$ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']);
174 -}
353 + $installed = array();
354 + $copiedLocalDir = false;
175 355
176 -return implode(' || ', $ranges);
177 -}
356 + if (self::$canGetVendors) {
357 + $selfDir = self::getSelfDir();
358 + foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
359 + $vendorDir = strtr($vendorDir, '\\', '/');
360 + if (isset(self::$installedByVendor[$vendorDir])) {
361 + $installed[] = self::$installedByVendor[$vendorDir];
362 + } elseif (is_file($vendorDir.'/composer/installed.php')) {
363 + /** @var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array<string, array{pretty_version?: string, version?: string, reference?: string|null, type?: string, install_path?: string, aliases?: string[], dev_requirement: bool, replaced?: string[], provided?: string[]}>} $required */
364 + $required = require $vendorDir.'/composer/installed.php';
365 + self::$installedByVendor[$vendorDir] = $required;
366 + $installed[] = $required;
367 + if (self::$installed === null && $vendorDir.'/composer' === $selfDir) {
368 + self::$installed = $required;
369 + self::$installedIsLocalDir = true;
370 + }
371 + }
372 + if (self::$installedIsLocalDir && $vendorDir.'/composer' === $selfDir) {
373 + $copiedLocalDir = true;
374 + }
375 + }
376 + }
178 377
179 -throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
180 -}
378 + if (null === self::$installed) {
379 + // only require the installed.php file if this file is loaded from its dumped location,
380 + // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
381 + if (substr(__DIR__, -8, 1) !== 'C') {
382 + /** @var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array<string, array{pretty_version?: string, version?: string, reference?: string|null, type?: string, install_path?: string, aliases?: string[], dev_requirement: bool, replaced?: string[], provided?: string[]}>} $required */
383 + $required = require __DIR__ . '/installed.php';
384 + self::$installed = $required;
385 + } else {
386 + self::$installed = array();
387 + }
388 + }
181 389
390 + if (self::$installed !== array() && !$copiedLocalDir) {
391 + $installed[] = self::$installed;
392 + }
182 393
183 -
184 -
185 -
186 -public static function getVersion($packageName)
187 -{
188 -foreach (self::getInstalled() as $installed) {
189 -if (!isset($installed['versions'][$packageName])) {
190 -continue;
191 -}
192 -
193 -if (!isset($installed['versions'][$packageName]['version'])) {
194 -return null;
195 -}
196 -
197 -return $installed['versions'][$packageName]['version'];
198 -}
199 -
200 -throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
201 -}
202 -
203 -
204 -
205 -
206 -
207 -public static function getPrettyVersion($packageName)
208 -{
209 -foreach (self::getInstalled() as $installed) {
210 -if (!isset($installed['versions'][$packageName])) {
211 -continue;
212 -}
213 -
214 -if (!isset($installed['versions'][$packageName]['pretty_version'])) {
215 -return null;
216 -}
217 -
218 -return $installed['versions'][$packageName]['pretty_version'];
219 -}
220 -
221 -throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
222 -}
223 -
224 -
225 -
226 -
227 -
228 -public static function getReference($packageName)
229 -{
230 -foreach (self::getInstalled() as $installed) {
231 -if (!isset($installed['versions'][$packageName])) {
232 -continue;
233 -}
234 -
235 -if (!isset($installed['versions'][$packageName]['reference'])) {
236 -return null;
237 -}
238 -
239 -return $installed['versions'][$packageName]['reference'];
240 -}
241 -
242 -throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
243 -}
244 -
245 -
246 -
247 -
248 -
249 -public static function getRootPackage()
250 -{
251 -$installed = self::getInstalled();
252 -
253 -return $installed[0]['root'];
254 -}
255 -
256 -
257 -
258 -
259 -
260 -
261 -
262 -
263 -public static function getRawData()
264 -{
265 -@trigger_error('getRawData only returns the first dataset loaded, which may not be what you expect. Use getAllRawData() instead which returns all datasets for all autoloaders present in the process.', E_USER_DEPRECATED);
266 -
267 -return self::$installed;
268 -}
269 -
270 -
271 -
272 -
273 -
274 -
275 -
276 -public static function getAllRawData()
277 -{
278 -return self::getInstalled();
279 -}
280 -
281 -
282 -
283 -
284 -
285 -
286 -
287 -
288 -
289 -
290 -
291 -
292 -
293 -
294 -
295 -
296 -
297 -
298 -
299 -public static function reload($data)
300 -{
301 -self::$installed = $data;
302 -self::$installedByVendor = array();
303 -}
304 -
305 -
306 -
307 -
308 -
309 -private static function getInstalled()
310 -{
311 -if (null === self::$canGetVendors) {
312 -self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders');
313 -}
314 -
315 -$installed = array();
316 -
317 -if (self::$canGetVendors) {
318 -foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
319 -if (isset(self::$installedByVendor[$vendorDir])) {
320 -$installed[] = self::$installedByVendor[$vendorDir];
321 -} elseif (is_file($vendorDir.'/composer/installed.php')) {
322 -$installed[] = self::$installedByVendor[$vendorDir] = require $vendorDir.'/composer/installed.php';
323 -}
324 -}
325 -}
326 -
327 -$installed[] = self::$installed;
328 -
329 -return $installed;
330 -}
394 + return $installed;
395 + }
331 396 }