PluginProbe
WP Debugging / 2.9.2
WP Debugging v2.9.2
2.12.6 2.12.5 trunk 2.10.0 2.10.1 2.10.2 2.11.0 2.11.1 2.11.10 2.11.11 2.11.12 2.11.13 2.11.14 2.11.15 2.11.16 2.11.17 2.11.18 2.11.19 2.11.2 2.11.20 2.11.21 2.11.22 2.11.23 2.11.24 2.11.3 All 59 releases
← All changes | vendor/composer/InstalledVersions.php +265 -298 2.11.122.9.2 View file →
@@ -1,352 +1,319 @@
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 mixed[]|null
31 - * @psalm-var array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array<string, array{dev_requirement: bool, pretty_version?: string, version?: string, aliases?: string[], reference?: string, replaced?: string[], provided?: string[], install_path?: string, type?: string}>}|array{}|null
32 - */
33 - private static $installed;
25 +private static $installed = array (
26 + 'root' =>
27 + array (
28 + 'pretty_version' => 'dev-master',
29 + 'version' => 'dev-master',
30 + 'aliases' =>
31 + array (
32 + ),
33 + 'reference' => 'f9aa32750b634b4cc837ea649e8565879deeb542',
34 + 'name' => 'afragen/wp-debugging',
35 + ),
36 + 'versions' =>
37 + array (
38 + 'afragen/wp-debugging' =>
39 + array (
40 + 'pretty_version' => 'dev-master',
41 + 'version' => 'dev-master',
42 + 'aliases' =>
43 + array (
44 + ),
45 + 'reference' => 'f9aa32750b634b4cc837ea649e8565879deeb542',
46 + ),
47 + 'afragen/wp-dependency-installer' =>
48 + array (
49 + 'pretty_version' => '3.1.0',
50 + 'version' => '3.1.0.0',
51 + 'aliases' =>
52 + array (
53 + ),
54 + 'reference' => '65570a1eb966bb9adfc9d9e521357da080fbdc5a',
55 + ),
56 + 'collizo4sky/persist-admin-notices-dismissal' =>
57 + array (
58 + 'pretty_version' => '1.4.4',
59 + 'version' => '1.4.4.0',
60 + 'aliases' =>
61 + array (
62 + ),
63 + 'reference' => '900739eb6b0ec0210465f5983a6d4e0e420289e4',
64 + ),
65 + 'norcross/debug-quick-look' =>
66 + array (
67 + 'pretty_version' => '0.1.5',
68 + 'version' => '0.1.5.0',
69 + 'aliases' =>
70 + array (
71 + ),
72 + 'reference' => NULL,
73 + ),
74 + 'wp-cli/wp-config-transformer' =>
75 + array (
76 + 'pretty_version' => 'v1.2.8',
77 + 'version' => '1.2.8.0',
78 + 'aliases' =>
79 + array (
80 + ),
81 + 'reference' => '0bb2b9162c38ca72370380aea11dc06e431e13a5',
82 + ),
83 + ),
84 +);
85 +private static $canGetVendors;
86 +private static $installedByVendor = array();
34 87
35 - /**
36 - * @var bool|null
37 - */
38 - private static $canGetVendors;
39 88
40 - /**
41 - * @var array[]
42 - * @psalm-var array<string, array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array<string, array{dev_requirement: bool, pretty_version?: string, version?: string, aliases?: string[], reference?: string, replaced?: string[], provided?: string[], install_path?: string, type?: string}>}>
43 - */
44 - private static $installedByVendor = array();
45 89
46 - /**
47 - * Returns a list of all package names which are present, either by being installed, replaced or provided
48 - *
49 - * @return string[]
50 - * @psalm-return list<string>
51 - */
52 - public static function getInstalledPackages()
53 - {
54 - $packages = array();
55 - foreach (self::getInstalled() as $installed) {
56 - $packages[] = array_keys($installed['versions']);
57 - }
58 90
59 - if (1 === \count($packages)) {
60 - return $packages[0];
61 - }
62 91
63 - return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
64 - }
65 92
66 - /**
67 - * Returns a list of all package names with a specific type e.g. 'library'
68 - *
69 - * @param string $type
70 - * @return string[]
71 - * @psalm-return list<string>
72 - */
73 - public static function getInstalledPackagesByType($type)
74 - {
75 - $packagesByType = array();
76 93
77 - foreach (self::getInstalled() as $installed) {
78 - foreach ($installed['versions'] as $name => $package) {
79 - if (isset($package['type']) && $package['type'] === $type) {
80 - $packagesByType[] = $name;
81 - }
82 - }
83 - }
94 +public static function getInstalledPackages()
95 +{
96 +$packages = array();
97 +foreach (self::getInstalled() as $installed) {
98 +$packages[] = array_keys($installed['versions']);
99 +}
84 100
85 - return $packagesByType;
86 - }
87 101
88 - /**
89 - * Checks whether the given package is installed
90 - *
91 - * This also returns true if the package name is provided or replaced by another package
92 - *
93 - * @param string $packageName
94 - * @param bool $includeDevRequirements
95 - * @return bool
96 - */
97 - public static function isInstalled($packageName, $includeDevRequirements = true)
98 - {
99 - foreach (self::getInstalled() as $installed) {
100 - if (isset($installed['versions'][$packageName])) {
101 - return $includeDevRequirements || empty($installed['versions'][$packageName]['dev_requirement']);
102 - }
103 - }
102 +if (1 === \count($packages)) {
103 +return $packages[0];
104 +}
104 105
105 - return false;
106 - }
106 +return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
107 +}
107 108
108 - /**
109 - * Checks whether the given package satisfies a version constraint
110 - *
111 - * e.g. If you want to know whether version 2.3+ of package foo/bar is installed, you would call:
112 - *
113 - * Composer\InstalledVersions::satisfies(new VersionParser, 'foo/bar', '^2.3')
114 - *
115 - * @param VersionParser $parser Install composer/semver to have access to this class and functionality
116 - * @param string $packageName
117 - * @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
118 - * @return bool
119 - */
120 - public static function satisfies(VersionParser $parser, $packageName, $constraint)
121 - {
122 - $constraint = $parser->parseConstraints($constraint);
123 - $provided = $parser->parseConstraints(self::getVersionRanges($packageName));
124 109
125 - return $provided->matches($constraint);
126 - }
127 110
128 - /**
129 - * Returns a version constraint representing all the range(s) which are installed for a given package
130 - *
131 - * It is easier to use this via isInstalled() with the $constraint argument if you need to check
132 - * whether a given version of a package is installed, and not just whether it exists
133 - *
134 - * @param string $packageName
135 - * @return string Version constraint usable with composer/semver
136 - */
137 - public static function getVersionRanges($packageName)
138 - {
139 - foreach (self::getInstalled() as $installed) {
140 - if (!isset($installed['versions'][$packageName])) {
141 - continue;
142 - }
143 111
144 - $ranges = array();
145 - if (isset($installed['versions'][$packageName]['pretty_version'])) {
146 - $ranges[] = $installed['versions'][$packageName]['pretty_version'];
147 - }
148 - if (array_key_exists('aliases', $installed['versions'][$packageName])) {
149 - $ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']);
150 - }
151 - if (array_key_exists('replaced', $installed['versions'][$packageName])) {
152 - $ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']);
153 - }
154 - if (array_key_exists('provided', $installed['versions'][$packageName])) {
155 - $ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']);
156 - }
157 112
158 - return implode(' || ', $ranges);
159 - }
160 113
161 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
162 - }
163 114
164 - /**
165 - * @param string $packageName
166 - * @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
167 - */
168 - public static function getVersion($packageName)
169 - {
170 - foreach (self::getInstalled() as $installed) {
171 - if (!isset($installed['versions'][$packageName])) {
172 - continue;
173 - }
174 115
175 - if (!isset($installed['versions'][$packageName]['version'])) {
176 - return null;
177 - }
178 116
179 - return $installed['versions'][$packageName]['version'];
180 - }
117 +public static function isInstalled($packageName)
118 +{
119 +foreach (self::getInstalled() as $installed) {
120 +if (isset($installed['versions'][$packageName])) {
121 +return true;
122 +}
123 +}
181 124
182 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
183 - }
125 +return false;
126 +}
184 127
185 - /**
186 - * @param string $packageName
187 - * @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
188 - */
189 - public static function getPrettyVersion($packageName)
190 - {
191 - foreach (self::getInstalled() as $installed) {
192 - if (!isset($installed['versions'][$packageName])) {
193 - continue;
194 - }
195 128
196 - if (!isset($installed['versions'][$packageName]['pretty_version'])) {
197 - return null;
198 - }
199 129
200 - return $installed['versions'][$packageName]['pretty_version'];
201 - }
202 130
203 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
204 - }
205 131
206 - /**
207 - * @param string $packageName
208 - * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as reference
209 - */
210 - public static function getReference($packageName)
211 - {
212 - foreach (self::getInstalled() as $installed) {
213 - if (!isset($installed['versions'][$packageName])) {
214 - continue;
215 - }
216 132
217 - if (!isset($installed['versions'][$packageName]['reference'])) {
218 - return null;
219 - }
220 133
221 - return $installed['versions'][$packageName]['reference'];
222 - }
223 134
224 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
225 - }
226 135
227 - /**
228 - * @param string $packageName
229 - * @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.
230 - */
231 - public static function getInstallPath($packageName)
232 - {
233 - foreach (self::getInstalled() as $installed) {
234 - if (!isset($installed['versions'][$packageName])) {
235 - continue;
236 - }
237 136
238 - return isset($installed['versions'][$packageName]['install_path']) ? $installed['versions'][$packageName]['install_path'] : null;
239 - }
240 137
241 - throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
242 - }
243 138
244 - /**
245 - * @return array
246 - * @psalm-return array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}
247 - */
248 - public static function getRootPackage()
249 - {
250 - $installed = self::getInstalled();
251 139
252 - return $installed[0]['root'];
253 - }
254 140
255 - /**
256 - * Returns the raw installed.php data for custom implementations
257 - *
258 - * @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.
259 - * @return array[]
260 - * @psalm-return array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array<string, array{dev_requirement: bool, pretty_version?: string, version?: string, aliases?: string[], reference?: string, replaced?: string[], provided?: string[], install_path?: string, type?: string}>}
261 - */
262 - public static function getRawData()
263 - {
264 - @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);
141 +public static function satisfies(VersionParser $parser, $packageName, $constraint)
142 +{
143 +$constraint = $parser->parseConstraints($constraint);
144 +$provided = $parser->parseConstraints(self::getVersionRanges($packageName));
265 145
266 - if (null === self::$installed) {
267 - // only require the installed.php file if this file is loaded from its dumped location,
268 - // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
269 - if (substr(__DIR__, -8, 1) !== 'C') {
270 - self::$installed = include __DIR__ . '/installed.php';
271 - } else {
272 - self::$installed = array();
273 - }
274 - }
146 +return $provided->matches($constraint);
147 +}
275 148
276 - return self::$installed;
277 - }
278 149
279 - /**
280 - * Returns the raw data of all installed.php which are currently loaded for custom implementations
281 - *
282 - * @return array[]
283 - * @psalm-return list<array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array<string, array{dev_requirement: bool, pretty_version?: string, version?: string, aliases?: string[], reference?: string, replaced?: string[], provided?: string[], install_path?: string, type?: string}>}>
284 - */
285 - public static function getAllRawData()
286 - {
287 - return self::getInstalled();
288 - }
289 150
290 - /**
291 - * Lets you reload the static array from another file
292 - *
293 - * This is only useful for complex integrations in which a project needs to use
294 - * this class but then also needs to execute another project's autoloader in process,
295 - * and wants to ensure both projects have access to their version of installed.php.
296 - *
297 - * A typical case would be PHPUnit, where it would need to make sure it reads all
298 - * the data it needs from this class, then call reload() with
299 - * `require $CWD/vendor/composer/installed.php` (or similar) as input to make sure
300 - * the project in which it runs can then also use this class safely, without
301 - * interference between PHPUnit's dependencies and the project's dependencies.
302 - *
303 - * @param array[] $data A vendor/composer/installed.php data set
304 - * @return void
305 - *
306 - * @psalm-param array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array<string, array{dev_requirement: bool, pretty_version?: string, version?: string, aliases?: string[], reference?: string, replaced?: string[], provided?: string[], install_path?: string, type?: string}>} $data
307 - */
308 - public static function reload($data)
309 - {
310 - self::$installed = $data;
311 - self::$installedByVendor = array();
312 - }
313 151
314 - /**
315 - * @return array[]
316 - * @psalm-return list<array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array<string, array{dev_requirement: bool, pretty_version?: string, version?: string, aliases?: string[], reference?: string, replaced?: string[], provided?: string[], install_path?: string, type?: string}>}>
317 - */
318 - private static function getInstalled()
319 - {
320 - if (null === self::$canGetVendors) {
321 - self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders');
322 - }
323 152
324 - $installed = array();
325 153
326 - if (self::$canGetVendors) {
327 - foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
328 - if (isset(self::$installedByVendor[$vendorDir])) {
329 - $installed[] = self::$installedByVendor[$vendorDir];
330 - } elseif (is_file($vendorDir.'/composer/installed.php')) {
331 - $installed[] = self::$installedByVendor[$vendorDir] = require $vendorDir.'/composer/installed.php';
332 - if (null === self::$installed && strtr($vendorDir.'/composer', '\\', '/') === strtr(__DIR__, '\\', '/')) {
333 - self::$installed = $installed[count($installed) - 1];
334 - }
335 - }
336 - }
337 - }
338 154
339 - if (null === self::$installed) {
340 - // only require the installed.php file if this file is loaded from its dumped location,
341 - // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
342 - if (substr(__DIR__, -8, 1) !== 'C') {
343 - self::$installed = require __DIR__ . '/installed.php';
344 - } else {
345 - self::$installed = array();
346 - }
347 - }
348 - $installed[] = self::$installed;
349 155
350 - return $installed;
351 - }
156 +
157 +
158 +public static function getVersionRanges($packageName)
159 +{
160 +foreach (self::getInstalled() as $installed) {
161 +if (!isset($installed['versions'][$packageName])) {
162 +continue;
163 +}
164 +
165 +$ranges = array();
166 +if (isset($installed['versions'][$packageName]['pretty_version'])) {
167 +$ranges[] = $installed['versions'][$packageName]['pretty_version'];
168 +}
169 +if (array_key_exists('aliases', $installed['versions'][$packageName])) {
170 +$ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']);
171 +}
172 +if (array_key_exists('replaced', $installed['versions'][$packageName])) {
173 +$ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']);
174 +}
175 +if (array_key_exists('provided', $installed['versions'][$packageName])) {
176 +$ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']);
177 +}
178 +
179 +return implode(' || ', $ranges);
180 +}
181 +
182 +throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
183 +}
184 +
185 +
186 +
187 +
188 +
189 +public static function getVersion($packageName)
190 +{
191 +foreach (self::getInstalled() as $installed) {
192 +if (!isset($installed['versions'][$packageName])) {
193 +continue;
194 +}
195 +
196 +if (!isset($installed['versions'][$packageName]['version'])) {
197 +return null;
198 +}
199 +
200 +return $installed['versions'][$packageName]['version'];
201 +}
202 +
203 +throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
204 +}
205 +
206 +
207 +
208 +
209 +
210 +public static function getPrettyVersion($packageName)
211 +{
212 +foreach (self::getInstalled() as $installed) {
213 +if (!isset($installed['versions'][$packageName])) {
214 +continue;
215 +}
216 +
217 +if (!isset($installed['versions'][$packageName]['pretty_version'])) {
218 +return null;
219 +}
220 +
221 +return $installed['versions'][$packageName]['pretty_version'];
222 +}
223 +
224 +throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
225 +}
226 +
227 +
228 +
229 +
230 +
231 +public static function getReference($packageName)
232 +{
233 +foreach (self::getInstalled() as $installed) {
234 +if (!isset($installed['versions'][$packageName])) {
235 +continue;
236 +}
237 +
238 +if (!isset($installed['versions'][$packageName]['reference'])) {
239 +return null;
240 +}
241 +
242 +return $installed['versions'][$packageName]['reference'];
243 +}
244 +
245 +throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
246 +}
247 +
248 +
249 +
250 +
251 +
252 +public static function getRootPackage()
253 +{
254 +$installed = self::getInstalled();
255 +
256 +return $installed[0]['root'];
257 +}
258 +
259 +
260 +
261 +
262 +
263 +
264 +
265 +public static function getRawData()
266 +{
267 +return self::$installed;
268 +}
269 +
270 +
271 +
272 +
273 +
274 +
275 +
276 +
277 +
278 +
279 +
280 +
281 +
282 +
283 +
284 +
285 +
286 +
287 +
288 +public static function reload($data)
289 +{
290 +self::$installed = $data;
291 +self::$installedByVendor = array();
292 +}
293 +
294 +
295 +
296 +
297 +private static function getInstalled()
298 +{
299 +if (null === self::$canGetVendors) {
300 +self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders');
301 +}
302 +
303 +$installed = array();
304 +
305 +if (self::$canGetVendors) {
306 +foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
307 +if (isset(self::$installedByVendor[$vendorDir])) {
308 +$installed[] = self::$installedByVendor[$vendorDir];
309 +} elseif (is_file($vendorDir.'/composer/installed.php')) {
310 +$installed[] = self::$installedByVendor[$vendorDir] = require $vendorDir.'/composer/installed.php';
311 +}
312 +}
313 +}
314 +
315 +$installed[] = self::$installed;
316 +
317 +return $installed;
318 +}
352 319 }