Allow tests to opt out of the data providers argument count validation

[stof]

PHPUnit 12 has added a warning when a data provider has more values than the number of arguments.

While this warning might allow to catch legitimate mistakes, I have cases where I intentionally relied on the fact that PHP does not forbid passing extra arguments to a function call. This happens when several tests reuse the same data provider, but one of them does not care about the last provided value. I could add an unused parameter, but CS tools would then report it as unused.

Example use case

class VoterTest extends TestCase
{
    // setup omitted, as well as the implementation of custom assertions

    /**
     * Administrator users are granted the security attributes regardless of
     * their permission profile value.
     */
    #[DataProvider('providePermissionMapping')]
    public function testGrantedForAdministrator(string $attribute): void
    {
        $this->currentMember->isAdministrator()->willReturn(true);

        $this->assertGranted($attribute);
    }

    #[DataProvider('providePermissionMapping')]
    public function testGrantedWithPermission(string $attribute, string $profilePermission): void
    {
        $this->permissionChecker->check($profilePermission, $this->user)->willReturn(true);

        $this->assertGranted($attribute);
    }

    #[DataProvider('providePermissionMapping')]
    public function testDeniedWithoutPermission(string $attribute, string $profilePermission): void
    {
        $this->permissionChecker->check($profilePermission, $this->user)->willReturn(false);

        $this->assertDenied($attribute);
    }

    /**
     * @return iterable<array{string, string}>
     */
    public static function providePermissionMapping(): iterable
    {
        // ...
    }
}

To support this use case, it would be great if a test could opt-out of this validation (maybe with a property in the DataProvider attribute, maybe with a separate AllowExtraProvidedArguments attribute, or whatever the name).
Note that such opt-out makes sense only for attributes allowing to use reusable data providers (DataProvider and DataProviderExternal), not for TestWith (as this is specific to a test, there is no use cases for a mismatch)

[sebastianbergmann]

My first idea would be to introduce an optional parameter to the DataProvider and DataProviderExternal attributes that controls this validation and defaults to true.

[kubawerlos]

I could add an unused parameter, but CS tools would then report it as unused.

@stof, would they? I have added one unused parameter in kubawerlos/php-cs-fixer-custom-fixers#1030 and PHPStan on max level and Psalm on 0 level are not reporting this.

[stof]

Phpstorm will report the argument as unused for instance, and suggest removing it.

[mvorisek]

My first idea would be to introduce an optional parameter to the DataProvider and DataProviderExternal attributes that controls this validation and defaults to true.

An array can be allowed in the optional parameter to skip the parameters explicitly, even positional ones, ex. [0] would skip 1st parameter of each data provider data.