如何解决PHPUnit测试中数据提供者重复冗余的问题，使用ergebnis/data-provider让你的测试代码更优雅高效

<pre class="brush:php;toolbar:false;"><?php

// ... 其他代码 ...

class UserTest extends \PHPUnit\Framework\TestCase
{
    // ... 其他测试方法 ...

    /**
     * @dataProvider provideInvalidUserNames
     */
    public function testUserNameCannotBeEmptyOrBlank(string $value): void
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionMessage('Value can not be an empty or blank string.');

        UserName::fromString($value);
    }

    public static function provideInvalidUserNames(): array
    {
        return [
            'empty string' => [''],
            'blank string with space' => [' '],
            'blank string with tab' => ["\t"],
            'blank string with newline' => ["\n"],
        ];
    }
}

// 假设有一个这样的 UserName 类
final class UserName
{
    private string $value;

    private function __construct(string $value)
    {
        $this->value = $value;
    }

    public static function fromString(string $value): self
    {
        if (trim($value) === '') {
            throw new \InvalidArgumentException('Value can not be an empty or blank string.');
        }

        return new self($value);
    }
}

ergebnis/data-provider

ergebnis/data-provider

ergebnis/data-provider

<pre class="brush:php;toolbar:false;">composer require ergebnis/data-provider

ergebnis/data-provider

<pre class="brush:php;toolbar:false;"><?php

declare(strict_types=1);

namespace Example\Test;

use Ergebnis\DataProvider;
use PHPUnit\Framework;
use InvalidArgumentException; // 假设 UserName::fromString 抛出此异常

// 假设有一个这样的 UserName 类
final class UserName
{
    private string $value;

    private function __construct(string $value)
    {
        $this->value = $value;
    }

    public static function fromString(string $value): self
    {
        if (trim($value) === '') {
            throw new InvalidArgumentException('Value can not be an empty or blank string.');
        }

        return new self($value);
    }
}

final class ExampleTest extends Framework\TestCase
{
    /**
     * @dataProvider \Ergebnis\DataProvider\StringProvider::blank()
     * @dataProvider \Ergebnis\DataProvider\StringProvider::empty()
     */
    public function testFromNameRejectsInvalidValueWithAnnotation(string $value): void
    {
        $this->expectException(InvalidArgumentException::class);
        $this->expectExceptionMessage('Value can not be an empty or blank string.');

        UserName::fromString($value);
    }

    // 如果你使用 PHP 8+ 的 Attribute，也可以这样写：
    #[Framework\DataProviderExternal(DataProvider\StringProvider::class, 'blank')]
    #[Framework\DataProviderExternal(DataProvider\StringProvider::class, 'empty')]
    public function testFromNameRejectsInvalidValueWithAttribute(string $value): void
    {
        $this->expectException(InvalidArgumentException::class);
        $this->expectExceptionMessage('Value can not be an empty or blank string.');

        UserName::fromString($value);
    }
}

provideInvalidUserNames()

Ergebnis\DataProvider\StringProvider

blank()

empty()

ergebnis/data-provider

ergebnis/data-provider

ergebnis/data-provider