PluginProbe
User Access Manager / 2.2.11
User Access Manager v2.2.11
2.3.20 2.3.19 2.3.18 2.3.17 2.3.16 2.3.15 2.3.14 2.3.13 trunk 0.6 0.6.1 0.6.2 0.7 0.7 Beta 0.7.0.1 0.8 0.8.0.1 0.8.0.2 0.9 0.9.1 0.9.1.1 0.9.1.2 0.9.1.3 0.9.1.4 1.0 All 136 releases
← All changes | vendor/composer/InstalledVersions.php +223 -336 2.3.132.2.11 View file →
@@ -1,396 +1,283 @@
1 1 <?php
2 2
3 -/*
4 - * This file is part of Composer.
5 - *
6 - * (c) Nils Adermann <naderman@naderman.de>
7 - * Jordi Boggiano <j.boggiano@seld.be>
8 - *
9 - * For the full copyright and license information, please view the LICENSE
10 - * file that was distributed with this source code.
11 - */
12 3
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 - * 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 - */
18 +
19 +
20 +
21 +
22 +
27 23 class InstalledVersions
28 24 {
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;
25 +private static $installed = array (
26 + 'root' =>
27 + array (
28 + 'pretty_version' => '2.2.11',
29 + 'version' => '2.2.11.0',
30 + 'aliases' =>
31 + array (
32 + ),
33 + 'reference' => NULL,
34 + 'name' => 'gmalex/user-access-manager',
35 + ),
36 + 'versions' =>
37 + array (
38 + 'gmalex/user-access-manager' =>
39 + array (
40 + 'pretty_version' => '2.2.11',
41 + 'version' => '2.2.11.0',
42 + 'aliases' =>
43 + array (
44 + ),
45 + 'reference' => NULL,
46 + ),
47 + ),
48 +);
49 +private static $canGetVendors;
50 +private static $installedByVendor = array();
34 51
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;
40 52
41 - /**
42 - * @var bool
43 - */
44 - private static $installedIsLocalDir;
45 53
46 - /**
47 - * @var bool|null
48 - */
49 - private static $canGetVendors;
50 54
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();
56 55
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 - }
69 56
70 - if (1 === \count($packages)) {
71 - return $packages[0];
72 - }
73 57
74 - return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
75 - }
58 +public static function getInstalledPackages()
59 +{
60 +$packages = array();
61 +foreach (self::getInstalled() as $installed) {
62 +$packages[] = array_keys($installed['versions']);
63 +}
76 64
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();
87 65
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 - }
66 +if (1 === \count($packages)) {
67 +return $packages[0];
68 +}
95 69
96 - return $packagesByType;
97 - }
70 +return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
71 +}
98 72
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 - }
115 73
116 - return false;
117 - }
118 74
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));
135 75
136 - return $provided->matches($constraint);
137 - }
138 76
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 - }
154 77
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 - }
168 78
169 - return implode(' || ', $ranges);
170 - }
171 79
172 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
173 - }
174 80
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 - }
81 +public static function isInstalled($packageName)
82 +{
83 +foreach (self::getInstalled() as $installed) {
84 +if (isset($installed['versions'][$packageName])) {
85 +return true;
86 +}
87 +}
185 88
186 - if (!isset($installed['versions'][$packageName]['version'])) {
187 - return null;
188 - }
89 +return false;
90 +}
189 91
190 - return $installed['versions'][$packageName]['version'];
191 - }
192 92
193 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
194 - }
195 93
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 - }
206 94
207 - if (!isset($installed['versions'][$packageName]['pretty_version'])) {
208 - return null;
209 - }
210 95
211 - return $installed['versions'][$packageName]['pretty_version'];
212 - }
213 96
214 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
215 - }
216 97
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 - }
227 98
228 - if (!isset($installed['versions'][$packageName]['reference'])) {
229 - return null;
230 - }
231 99
232 - return $installed['versions'][$packageName]['reference'];
233 - }
234 100
235 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
236 - }
237 101
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 - }
248 102
249 - return isset($installed['versions'][$packageName]['install_path']) ? $installed['versions'][$packageName]['install_path'] : null;
250 - }
251 103
252 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
253 - }
254 104
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();
105 +public static function satisfies(VersionParser $parser, $packageName, $constraint)
106 +{
107 +$constraint = $parser->parseConstraints($constraint);
108 +$provided = $parser->parseConstraints(self::getVersionRanges($packageName));
262 109
263 - return $installed[0]['root'];
264 - }
110 +return $provided->matches($constraint);
111 +}
265 112
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);
276 113
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 - }
286 114
287 - return self::$installed;
288 - }
289 115
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 - }
300 116
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();
323 117
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 - }
330 118
331 - /**
332 - * @return string
333 - */
334 - private static function getSelfDir()
335 - {
336 - if (self::$selfDir === null) {
337 - self::$selfDir = strtr(__DIR__, '\\', '/');
338 - }
339 119
340 - return self::$selfDir;
341 - }
342 120
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 - }
352 121
353 - $installed = array();
354 - $copiedLocalDir = false;
122 +public static function getVersionRanges($packageName)
123 +{
124 +foreach (self::getInstalled() as $installed) {
125 +if (!isset($installed['versions'][$packageName])) {
126 +continue;
127 +}
355 128
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 - }
129 +$ranges = array();
130 +if (isset($installed['versions'][$packageName]['pretty_version'])) {
131 +$ranges[] = $installed['versions'][$packageName]['pretty_version'];
132 +}
133 +if (array_key_exists('aliases', $installed['versions'][$packageName])) {
134 +$ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']);
135 +}
136 +if (array_key_exists('replaced', $installed['versions'][$packageName])) {
137 +$ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']);
138 +}
139 +if (array_key_exists('provided', $installed['versions'][$packageName])) {
140 +$ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']);
141 +}
377 142
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 - }
143 +return implode(' || ', $ranges);
144 +}
389 145
390 - if (self::$installed !== array() && !$copiedLocalDir) {
391 - $installed[] = self::$installed;
392 - }
146 +throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
147 +}
393 148
394 - return $installed;
395 - }
149 +
150 +
151 +
152 +
153 +public static function getVersion($packageName)
154 +{
155 +foreach (self::getInstalled() as $installed) {
156 +if (!isset($installed['versions'][$packageName])) {
157 +continue;
158 +}
159 +
160 +if (!isset($installed['versions'][$packageName]['version'])) {
161 +return null;
162 +}
163 +
164 +return $installed['versions'][$packageName]['version'];
165 +}
166 +
167 +throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
168 +}
169 +
170 +
171 +
172 +
173 +
174 +public static function getPrettyVersion($packageName)
175 +{
176 +foreach (self::getInstalled() as $installed) {
177 +if (!isset($installed['versions'][$packageName])) {
178 +continue;
179 +}
180 +
181 +if (!isset($installed['versions'][$packageName]['pretty_version'])) {
182 +return null;
183 +}
184 +
185 +return $installed['versions'][$packageName]['pretty_version'];
186 +}
187 +
188 +throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
189 +}
190 +
191 +
192 +
193 +
194 +
195 +public static function getReference($packageName)
196 +{
197 +foreach (self::getInstalled() as $installed) {
198 +if (!isset($installed['versions'][$packageName])) {
199 +continue;
200 +}
201 +
202 +if (!isset($installed['versions'][$packageName]['reference'])) {
203 +return null;
204 +}
205 +
206 +return $installed['versions'][$packageName]['reference'];
207 +}
208 +
209 +throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
210 +}
211 +
212 +
213 +
214 +
215 +
216 +public static function getRootPackage()
217 +{
218 +$installed = self::getInstalled();
219 +
220 +return $installed[0]['root'];
221 +}
222 +
223 +
224 +
225 +
226 +
227 +
228 +
229 +public static function getRawData()
230 +{
231 +return self::$installed;
232 +}
233 +
234 +
235 +
236 +
237 +
238 +
239 +
240 +
241 +
242 +
243 +
244 +
245 +
246 +
247 +
248 +
249 +
250 +
251 +
252 +public static function reload($data)
253 +{
254 +self::$installed = $data;
255 +self::$installedByVendor = array();
256 +}
257 +
258 +
259 +
260 +
261 +private static function getInstalled()
262 +{
263 +if (null === self::$canGetVendors) {
264 +self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders');
265 +}
266 +
267 +$installed = array();
268 +
269 +if (self::$canGetVendors) {
270 +foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
271 +if (isset(self::$installedByVendor[$vendorDir])) {
272 +$installed[] = self::$installedByVendor[$vendorDir];
273 +} elseif (is_file($vendorDir.'/composer/installed.php')) {
274 +$installed[] = self::$installedByVendor[$vendorDir] = require $vendorDir.'/composer/installed.php';
275 +}
276 +}
277 +}
278 +
279 +$installed[] = self::$installed;
280 +
281 +return $installed;
282 +}
396 283 }