Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Ocramius/PackageVersions
:package: Composer addon to efficiently get installed packages' version numbers
https://github.com/Ocramius/PackageVersions
Last synced: about 1 month ago
JSON representation
:package: Composer addon to efficiently get installed packages' version numbers
- Host: GitHub
- URL: https://github.com/Ocramius/PackageVersions
- Owner: Ocramius
- License: mit
- Created: 2016-01-25T18:48:05.000Z (almost 9 years ago)
- Default Branch: 2.10.x
- Last Pushed: 2024-11-05T06:03:37.000Z (about 1 month ago)
- Last Synced: 2024-11-05T23:43:07.690Z (about 1 month ago)
- Language: PHP
- Homepage:
- Size: 940 KB
- Stars: 3,221
- Watchers: 21
- Forks: 68
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- php-awesome - PackageVersions - 获取已安装的 Composer 扩展的版本号 (Composer / PRC)
- awesome-composer - PackageVersions - Provides a very quick and easy access to installed composer dependency versions. (Plugins / Support)
README
# Package Versions
## A message to Russian 🇷🇺 people
If you currently live in Russia, please read [this message](./ToRussianPeople.md).
### Purpose
This utility provides quick and easy access to version information of composer dependencies.
This information is derived from the ```composer.lock``` file which is (re)generated during ```composer install``` or ```composer update```.
```php
$version = \PackageVersions\Versions::getVersion('ocramius/package-versions');
var_dump($version); // 1.0.0@0beec7b5ea3f0fdbc95d0dd47f3c5bc275da8a33
```
[](https://dashboard.stryker-mutator.io/reports/github.com/Ocramius/PackageVersions/2.0.x)
[](https://shepherd.dev/github/Ocramius/PackageVersions)
[](https://packagist.org/packages/ocramius/package-versions)
[](https://packagist.org/packages/ocramius/package-versions)
[](https://tidelift.com/subscription/pkg/packagist-ocramius%2Fpackage-versions?utm_source=packagist-ocramius%2Fpackage-versions&utm_medium=readme)
### Installation
```sh
composer require ocramius/package-versions
```
It is suggested that you use [an optimized composer autoloader](https://getcomposer.org/doc/06-config.md#optimize-autoloader) (to prevent autoload I/O when accessing the `PackageVersions\Versions` API) in your composer.json:
```json
...
"config": {
"optimize-autoloader": true
},
...
```
In case you manually generate your autoloader via the CLI use the `--optimize` flag:
```sh
composer dump-autoload --optimize
```
### Use-cases
This repository implements `PackageVersions\Versions::getVersion()` in such a way that no IO
happens when calling it, because the list of package versions is compiled during composer
installation.
This is especially useful when you want to generate assets/code/artifacts that are computed from
the current version of a certain dependency. Doing so at runtime by checking the installed
version of a package would be too expensive, and this package mitigates that.
## ocramius/package-versions for enterprise
Available as part of the Tidelift Subscription.
The maintainer of ocramius/package-versions and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/packagist-ocramius-package-versions?utm_source=packagist-ocramius-package-versions&utm_medium=referral&utm_campaign=enterprise&utm_term=repo).
You can also contact the maintainer at [email protected] for looking into issues related to this package
in your private projects.