Версия: 6.x
burger close
Класс InstalledVersions

Подробное описание

This class is copied in every Composer installed project and available to all

See also https://getcomposer.org/doc/07-runtime.md#installed-versions

To require its presence, you can require composer-runtime-api ^2.0

Открытые статические члены

static getInstalledPackages ()
 
static getInstalledPackagesByType ($type)
 
static isInstalled ($packageName, $includeDevRequirements=true)
 
static satisfies (VersionParser $parser, $packageName, $constraint)
 
static getVersionRanges ($packageName)
 
static getVersion ($packageName)
 
static getPrettyVersion ($packageName)
 
static getReference ($packageName)
 
static getInstallPath ($packageName)
 
static getRootPackage ()
 
static getRawData ()
 
static getAllRawData ()
 
static reload ($data)
 

Методы

static getAllRawData ( )
static

Returns the raw data of all installed.php which are currently loaded for custom implementations

Возвращает
array[] -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}>}>
static getInstalledPackages ( )
static

Returns a list of all package names which are present, either by being installed, replaced or provided

Возвращает
string[] -return list<string>
static getInstalledPackagesByType (   $type)
static

Returns a list of all package names with a specific type e.g. 'library'

Аргументы
string$type
Возвращает
string[] -return list<string>
static getInstallPath (   $packageName)
static
Аргументы
string$packageName
Возвращает
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.
static getPrettyVersion (   $packageName)
static
Аргументы
string$packageName
Возвращает
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
static getRawData ( )
static

Returns the raw installed.php data for custom implementations

static getReference (   $packageName)
static
Аргументы
string$packageName
Возвращает
string|null If the package is being replaced or provided but is not really installed, null will be returned as reference
static getRootPackage ( )
static
Возвращает
array -return array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}
static getVersion (   $packageName)
static
Аргументы
string$packageName
Возвращает
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
static getVersionRanges (   $packageName)
static

Returns a version constraint representing all the range(s) which are installed for a given package

It is easier to use this via isInstalled() with the $constraint argument if you need to check whether a given version of a package is installed, and not just whether it exists

Аргументы
string$packageName
Возвращает
string Version constraint usable with composer/semver
static isInstalled (   $packageName,
  $includeDevRequirements = true 
)
static

Checks whether the given package is installed

This also returns true if the package name is provided or replaced by another package

Аргументы
string$packageName
bool$includeDevRequirements
Возвращает
bool
static reload (   $data)
static

Lets you reload the static array from another file

This is only useful for complex integrations in which a project needs to use this class but then also needs to execute another project's autoloader in process, and wants to ensure both projects have access to their version of installed.php.

A typical case would be PHPUnit, where it would need to make sure it reads all the data it needs from this class, then call reload() with require $CWD/vendor/composer/installed.php (or similar) as input to make sure the project in which it runs can then also use this class safely, without interference between PHPUnit's dependencies and the project's dependencies.

Аргументы
array[]$data A vendor/composer/installed.php data set
Возвращает
void

-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

static satisfies ( VersionParser  $parser,
  $packageName,
  $constraint 
)
static

Checks whether the given package satisfies a version constraint

e.g. If you want to know whether version 2.3+ of package foo/bar is installed, you would call:

Composer::satisfies(new VersionParser, 'foo/bar', '^2.3')

Аргументы
VersionParser$parserInstall composer/semver to have access to this class and functionality
string$packageName
string | null$constraintA version constraint to check for, if you pass one you have to make sure composer/semver is required by your package
Возвращает
bool