[composer-based] Bond version-specific rules to composer package constraints

[TomasVotruba]

Some rules and configurations emit APIs that only exist since a specific PHPUnit version, but carry no version bond. Applied to an older PHPUnit, they produce code that fatals.

Every version below was resolved from the sebastianbergmann/phpunit git history (git tag --contains <commit>), not from memory.

Rules

rule	bond	what breaks without it
AllowMockObjectsWhereParentClassRector	>=12.5.2	#[AllowMockObjectsWithoutExpectations] does not exist yet (24c208d)
AllowMockObjectsForDataProviderRector	>=12.5.2	same attribute
AllowMockObjectsWithoutExpectationsAttributeRector	>=12.5.2	same attribute
RemoveOverrideFinalConstructTestCaseRector	>=12.0.3	TestCase::__construct() is only final since then (3263f4c)
InlineStubPropertyToCreateStubMethodCallRector	>=11.0	stub/mock split, matches the already bonded siblings
SingleMockPropertyTypeRector	>=11.0	same
ChangeMockObjectReturnUnionToIntersectionRector	>=11.0	same

 use Symfony\Component\Form\Test\TypeTestCase;

+#[\PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations]
 final class SomeTest extends TypeTestCase
 {
 }

On PHPUnit 12.5.1 and below that attribute class does not exist, so the test class fatals. With the bond, the rule is skipped instead of producing broken code.

Method renames

The generic RenameMethodRector configurations get the same treatment, each bound to the version that added the target method:

rename	target method added in
setMethods() → onlyMethods()	8.3
expectExceptionMessageRegExp() → expectExceptionMessageMatches()	8.4
assertRegExp(), assertNotRegExp(), assertFileNotExists(), assertFileNotIsReadable(), assertDirectoryNotExists(), assertDirectoryNotIsReadable(), assertDirectoryNotIsWritable(), assertNotIsReadable(), assertNotIsWritable()	9.1
getInvocationCount() → numberOfInvocations()	10.0
assertObjectHasAttribute() → assertObjectHasProperty()	10.1
expectExceptionMessage() → expectExceptionMessageIsOrContains()	13.2

-$this->assertObjectHasAttribute('someProperty', new stdClass());
-$this->expectExceptionMessage('some message');
+$this->assertObjectHasProperty('someProperty', new stdClass());
+$this->expectExceptionMessageIsOrContains('some message');

Two versions worth calling out, as they are a minor later than one would assume: assertObjectHasProperty() is 10.1, not 10.0, and expectExceptionMessageIsOrContains() is 13.2. The latter is the sharpest edge - rewriting expectExceptionMessage() on a project still on PHPUnit 11 or 12 points every call at a method that does not exist there.

Set registration

Everything is registered in composer-based.php, so it applies to any project whose installed PHPUnit matches, not only through the single upgrade set that used to carry it.

The per-version sets keep their current registrations untouched, so nothing changes for anyone already using them - a rule registered by both a version set and the composer-based set is tagged only once by RectorConfig::rule(), and rule configurations are merged.

Two tests/ComposerBased fixtures cover the constructor rule and the bounded renames arriving through the composer-based set.