PluginProbe
PayPlug for WooCommerce (Official) / 3.1.0
PayPlug for WooCommerce (Official) v3.1.0
3.1.0 3.0.0 2.18.0 1.0.17 1.0.18 1.0.19 1.0.20 1.0.21 1.0.22 1.0.3 1.0.4 1.0.5 1.0.6 1.0.7 1.0.8 1.1.0 1.10.0 1.10.1 1.2.1 1.2.10 1.2.11 1.2.2 1.2.3 1.2.4 1.2.5 All 102 releases
← All changes | vendor/composer/InstalledVersions.php +336 -271 1.10.0 → 3.1.0 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' => 'eba7cfede4fe49bd9d34d6bfcfc2493bd829957e',
36 - 'name' => 'payplug/payplug-woocommerce',
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 - 'payplug/payplug-php' =>
50 - array (
51 - 'pretty_version' => '3.5.4',
52 - 'version' => '3.5.4.0',
53 - 'aliases' =>
54 - array (
55 - ),
56 - 'reference' => '9fe3787e8ad98500141168447bb2b84c47c43be2',
57 - ),
58 - 'payplug/payplug-woocommerce' =>
59 - array (
60 - 'pretty_version' => 'dev-master',
61 - 'version' => 'dev-master',
62 - 'aliases' =>
63 - array (
64 - ),
65 - 'reference' => 'eba7cfede4fe49bd9d34d6bfcfc2493bd829957e',
66 - ),
67 - 'roundcube/plugin-installer' =>
68 - array (
69 - 'replaced' =>
70 - array (
71 - 0 => '*',
72 - ),
73 - ),
74 - 'shama/baton' =>
75 - array (
76 - 'replaced' =>
77 - array (
78 - 0 => '*',
79 - ),
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 }