2.11.0 - 2025-11-27

Release Notes for 2.11.0

Feature release (minor)

2.11.0

• Total issues resolved: 0
• Total pull requests resolved: 4
• Total contributors: 2

dependencies,enhancement

• 270: Add PHP 8.5 support thanks to @samsonasik

renovate

• 269: Update dependency doctrine/coding-standard to v14 thanks to @renovate[bot]
• 268: Update actions/checkout action to v5 thanks to @renovate[bot]
• 266: Update dependency doctrine/coding-standard to v13 thanks to @renovate[bot]

2.10.0 - 2025-02-05

Release Notes for 2.10.0

Feature release (minor)

2.10.0

• Total issues resolved: 0
• Total pull requests resolved: 4
• Total contributors: 1

renovate

• 261: Update dependency vimeo/psalm to v6 thanks to @renovate[bot]
• 257: Roll back laminas/automatic-releases action to 1.24.0 - autoclosed thanks to @renovate[bot]
• 252: Update dependency phpunit/phpunit to v11 thanks to @renovate[bot]
• 246: Update dependency phpunit/phpunit to v10 - abandoned thanks to @renovate[bot]

2.9.0 - 2024-08-04

Release Notes for 2.9.0

Feature release (minor)

2.9.0

• Total issues resolved: 0
• Total pull requests resolved: 2
• Total contributors: 2

dependencies,enhancement

• 256: Allow PHP 8.4 thanks to @fezfez

security

• 253: Update dependency composer/composer to ^2.7.0 [SECURITY] thanks to @renovate[bot]

2.8.0 - 2023-09-15

Release Notes for 2.8.0

Feature release (minor)

2.8.0

• Total issues resolved: 0
• Total pull requests resolved: 4
• Total contributors: 2

enhancement

• 250: Allow php 8.3 thanks to @fezfez

renovate

• 249: Update actions/checkout action to v4 thanks to @renovate[bot]
• 245: Update dependency doctrine/coding-standard to v11 thanks to @renovate[bot]
• 244: Update dependency vimeo/psalm to v5 thanks to @renovate[bot]

2.7.0 - 2022-10-31

Release Notes for 2.7.0

Feature release (minor)

2.7.0

• Total issues resolved: 0
• Total pull requests resolved: 6
• Total contributors: 2

dependencies

• 243: Update dependency composer/composer to ^2.4.4 thanks to @Ocramius

renovate

• 242: Update all non-major dependencies, dropping PHP 8.0 support thanks to @renovate[bot]
• 240: Update dependency doctrine/coding-standard to v10 thanks to @renovate[bot]
• 238: Configure Renovate thanks to @renovate[bot]

security

• 239: Update dependency composer/composer to ^2.2.12 [SECURITY] - autoclosed thanks to @renovate[bot]

enhancement

• 233: Streamlined CI setup with laminas/laminas-ci-matrix-action thanks to @Ocramius

Release Notes for 2.6.0

Feature release (minor)

2.6.0

• Total issues resolved: 0
• Total pull requests resolved: 11
• Total contributors: 3

dependencies,enhancement

• 232: PHP 8.2 support thanks to @Ocramius
• 193: Upgraded all existing dependencies to their possible latest and greatest thanks to @Ocramius

dependencies,github_actions

• 218: Bump ridedott/merge-me-action from 2.10.14 to 2.10.15 thanks to @dependabot[bot]
• 217: Bump ridedott/merge-me-action from 2.10.13 to 2.10.14 thanks to @dependabot[bot]
• 215: Bump ridedott/merge-me-action from 2.10.6 to 2.10.12 thanks to @dependabot[bot]
• 210: Bump ridedott/merge-me-action from 2.10.5 to 2.10.6 thanks to @dependabot[bot]
• 209: Bump ridedott/merge-me-action from 2.10.4 to 2.10.5 thanks to @dependabot[bot]
• 208: Bump ridedott/merge-me-action from 2.9.60 to 2.10.4 thanks to @dependabot[bot]
• 203: Bump actions/cache from 2 to 3 thanks to @dependabot[bot]
• 195: Bump actions/checkout from 2 to 3 thanks to @dependabot[bot]

enhancement

• 202: Merge release 2.5.1 into 2.6.x thanks to @github-actions[bot]

Release Notes for 2.5.1

2.5.x bugfix release (patch)

2.5.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement,help wanted

• 201: Raise awareness of current Russia-Ukraine situation, targeting Russian 🇷🇺 readers thanks to @github-actions[bot]

Release Notes for 2.4.1

2.4.x bugfix release (patch)

2.4.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement,help wanted

• 200: Raise awareness of current Russia-Ukraine situation, targeting Russian 🇷🇺 readers thanks to @github-actions[bot]

2.3.1 - 2022-03-05

Release Notes for 2.3.1

2.3.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement,help wanted

• 199: Raise awareness of current Russia-Ukraine situation, targeting Russian 🇷🇺 readers thanks to @github-actions[bot]

Release Notes for 2.2.1

2.2.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement,help wanted

• 198: Raise awareness of current Russia-Ukraine situation, targeting Russian 🇷🇺 readers thanks to @github-actions[bot]

Release Notes for 2.1.1

2.1.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement,help wanted

• 197: Raise awareness of current Russia-Ukraine situation, targeting Russian 🇷🇺 readers thanks to @github-actions[bot]

Release Notes for 2.0.1

2.0.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement

• 196: Raise awareness of current Russia-Ukraine situation, targeting Russian 🇷🇺 readers thanks to @Ocramius

2.5.0 - 2021-12-22

Release Notes for 2.5.0

Feature release (minor)

2.5.0

• Total issues resolved: 0
• Total pull requests resolved: 6
• Total contributors: 2

dependencies,enhancement

• 192: Upgrade to composer/composer:2.2.0, trust dealerdirect/phpcodesniffer-composer-installer and run everything in CI with --no-interaction thanks to @Ocramius

dependencies,github_actions

• 188: Bump ridedott/merge-me-action from 2.9.54 to 2.9.60 thanks to @dependabot[bot]
• 182: Bump ridedott/merge-me-action from 2.9.48 to 2.9.52 thanks to @dependabot[bot]
• 179: Bump ridedott/merge-me-action from 2.9.46 to 2.9.48 thanks to @dependabot[bot]
• 177: Bump ridedott/merge-me-action from 2.9.42 to 2.9.46 thanks to @dependabot[bot]
• 175: Bump ridedott/merge-me-action from 2.9.40 to 2.9.42 thanks to @dependabot[bot]

2.4.0 - 2021-09-19

Release Notes for 2.4.0

2.4.0

• Total issues resolved: 0
• Total pull requests resolved: 2
• Total contributors: 2

enhancement

• 169: PHP 8.1 compatibility, upgrade CI dependencies, enable dependabot thanks to @Ocramius

dependencies

• 168: Upgrade to GitHub-native Dependabot thanks to @dependabot-preview[bot]

2.3.0 - 2020-12-23

Release Notes for 2.3.0

2.3.0

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement

• 164: Update .gitattributes to avoid exporting phpcs artifacts thanks to @reedy

Release Notes for 2.2.0

This release is mostly a cleanup to keep the test setup and CI pipelines small in size and manageable long-term, since maintaining both PHP 7 and PHP 8 support would (due to dependencies) become quite a lot of long-term effort otherwise.

If, for some reason, you require to run both PHP 7 and PHP 8 in different environments, use ocramius/package-versions:2.1.0, which supports both.

2.2.0

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement

• 162: Drop php:^7.4.7 support - switch to only php:~8.0.0 thanks to @Ocramius

Release Notes for 2.1.0

This patch explicitly adds php:~8.0.0 support along with php:^7.4.7.

phpunit/phpunit had to also be upgraded, so that it does not contain symbols that clash with the php:8.0.0 parser BC breaks.

To do so, we had to disable infection/infection reporting for now, as the mutation testing setup is not yet capable of working with phpunit/phpunit:^9.3.

In addition to that, we now actively replace composer/package-versions-deprecated, which is constantly causing issues in installation, and which is fully replaced by this specific package. If you run composer/composer:^2.0 and php:8.0.0, there is no reason to use composer/package-versions-deprecated anyway.

Please note that the support for PHP is limited to php:^7.4.7 || php:~8.0.0: php:8.1.0 is NOT supported by this release, as the upstream ecosystem is just too unstable and regularly breaks BC in multiple ways. Once php:8.1.0-rc2 is out (possibly next year), work will be done to support that too.

2.1.0

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement

• 161: Add php:8.0.* support thanks to @Ocramius

This release turns the package into a library (previously, it was a composer plugin).

Relevant change is that the PackageVersions\Versions::ROOT_PACKAGE_NAME constant no longer exists: please use PackageVersions\Versions::rootPackageName() instead.

This slims down the complexity of the package massively, and removes multiple known bugs.

Total issues resolved: 5

• 107: Unable to install on vboxfs thanks to @alexgit2k
• 138: src/Packages/Versions.php changes detected in composer install thanks to @Taluu
• 142: Option to ignore version of rootPackage thanks to @qurben
• 152: Ocramius/PackageVersions is not compatible with composer configuration "lock: false" thanks to @windaishi
• 155: BC break: removed deprecated PackageVersions\Versions::ROOT_PACKAGE_NAME constant thanks to @Ocramius

Release 2.0.0

This release turns the package into a library (previously, it was a composer plugin).

Relevant change is that the PackageVersions\Versions::ROOT_PACKAGE_NAME constant no longer exists: please use PackageVersions\Versions::rootPackageName() instead.

This slims down the complexity of the package massively, and removes multiple known bugs.

2.0.0

• Total issues resolved: 4
• Total pull requests resolved: 2
• Total contributors: 5

enhancement

• 156: Convert to "type": "library" composer package thanks to @Ocramius
• 155: BC break: removed deprecated PackageVersions\Versions::ROOT_PACKAGE_NAME constant thanks to @Ocramius and @alexgit2k

Release 1.11.0

1.11.0

• Total issues resolved: 1
• Total pull requests resolved: 1
• Total contributors: 1

enhancement

• 154: Implement #153 - added PackageVersions\Versions::rootPackageName() as replacement for PackageVersions\Versions::ROOT_PACKAGE_NAME thanks to @Ocramius

Release 1.10.2

1.10.2

• Total issues resolved: 1
• Total pull requests resolved: 1
• Total contributors: 2

bug

• 150: #148 retrieve root package version also when package is installed with --no-scripts thanks to @Ocramius and @stof

Introduced release automation tooling, which should also help us with keeping the changelog up-to-date long-term.

Release 1.10.1

1.10.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

enhancement

• 149: Enable automatic releases thanks to @Ocramius

This release increases the minimum supported version of composer to v2 (currently in alpha, but you should REALLY try it out).

By doing so, the code has been massively reduced, and a few relevant bugs around the detected installed package versions have been squished in the process.

In order to upgrade, you must first have composer v2 installed, which you can get by runnning its self-update tooling: composer self-update --2.

You can look at the in-depth thought-process behind this patch at https://www.twitch.tv/videos/640893205

Total issues resolved: 5

• 90: Test psalm annotations against a happy path/unhappy path static analysis test suite thanks to @Ocramius
• 116: FallbackVersions uses this package lock which breaks version checks thanks to @scaytrase
• 117: Expose and fix fallback versions thanks to @scaytrase
• 135: Drop support for Composer 1.x once stable thanks to @Ocramius
• 146: Rewrote package to use composer-runtime-api:^2.0 and no longer keep an internal generated map thanks to @Ocramius

This release allows ocramius/package-version to skip writing the Version class when the vendor directory is locked/not writable.

Total issues resolved: 2

• 136: PHPUnit update - use better assertion names, remove deprecations thanks to @michalbundyra
• 144: Skip generation of version classes in case when install path is not writable thanks to @0x450x6c

This release adds forward-compatibility for composer/composer:2.0.0.

Total issues resolved: 1

• 133: Add support for Composer 2.x thanks to @Seldaek

This release adds [@psalm-pure](https://github.com/psalm-pure) to the generated version of PackageVersions\Versions. Please note that if you run your composer installation with --no-scripts and --no-plugins, then the fallback version of PackageVersions\Versions will be in use, and therefore purity is not guaranteed.

Total issues resolved: 1

• 120: Ensure that, when generated, PackageVersions\Versions::getVersion() is [@psalm-pure](https://github.com/psalm-pure) thanks to @Ocramius

This release upgrades dependencies, improves testing/static analysis checks, and moves the package to PHP 7.4 as a minimum required engine version.

Total issues resolved: 4

• 111: Update .gitattributes thanks to @reedy
• 114: Travis CI config - PHP 7.4 stable builds thanks to @michalbundyra
• 115: Allow using internal/deprecated symbols, but only in the test suite thanks to @Ocramius
• 118: Upgrade dependencies, minimum PHP version upgraded to 7.4 thanks to @Ocramius

Total issues resolved: 1

• 113: Fix incorrect lookup path for installed.json thanks to @ArondeParon

This release ports the ability to rely on installed.json when composer.json is not available to the stable 1.4.x branch.

Total issues resolved: 1

• 112: Backport #82 to 1.4 thanks to @Jean85

This release fixes an issue leading FallbackVersions (used when installing with --no-scripts) to fail to detect composer.lock or installed.json locations due to getcwd() misbehavior during composer installation.

Total issues resolved: 2

• 101: Cannot locate composer.lock nor installed.json when using package with --no-scripts thanks to @PhilETaylor
• 102: #101 corrected scanned locations for installed.json and composer.json thanks to @Ocramius

This release improves discovery of versions when composer.lock cannot be located, falling back to installed.json (which is at a fixed relative filesystem location).

We removed duplicate plugin runs during install/update, and runs the plugin only during the POST_AUTOLOAD_DUMP event.

The minimum supported PHP version is now PHP 7.3.0.

PHP 7.4 compatibility issues with ReflectionType#__toString() have been fixed.

Static analysis additions will also now start highlighting issues in downstream projects using vimeo/psalm (at build-time) when non-existing dependency lookups are performed against PackageVersions\Versions::getVersion(), preventing useless runtime exceptions.

Total issues resolved: 12

• 81: added docs to Versions::VERSION thanks to @staabm
• 82: Use vendor/composer/installed.json and fallback to using composer.lock thanks to @9ae8sdf76
• 83: Update to doctrine/coding-standard v6.0.0 thanks to @carusogabriel
• 87: Added experimental github sponsorship/funding links through tidelift thanks to @Ocramius
• 88: Simplify autoloader notes thanks to @weshooper
• 89: Provide [@psalm-param](https://github.com/psalm-param) key-of<self::VERSIONS> type-check for downstream thanks to @Ocramius
• 91: dump the version class on composer dump-autoload thanks to @staabm
• 92: Failures on PHP 7.4 build due to ReflectionType#__toString() deprecations thanks to @Ocramius
• 93: updated dependencies thanks to @staabm
• 95: the POST_AUTOLOAD_DUMP event also happens on composer install/update thanks to @staabm
• 96: #90 add psalm static analysis tests thanks to @Ocramius
• 99: Bumped dependencies, dropped PHP 7.2.0 support, simplified build matrix thanks to @Ocramius