告别脏数据：如何使用oskarstark/trimmed-non-empty-string确保字符串的整洁与有效性

<pre class="brush:php;toolbar:false;">$username = $_POST['username'] ?? '';
$trimmedUsername = trim($username);

if (empty($trimmedUsername)) {
    throw new InvalidArgumentException('用户名不能为空！');
}

// 继续使用 $trimmedUsername

<code class="bash">composer require oskarstark/trimmed-non-empty-string</code>

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

declare(strict_types=1);

namespace App\Domain\Value\Name;

use OskarStark\Value\TrimmedNonEmptyString;
use InvalidArgumentException; // 确保导入此异常类

final class Name
{
    private string $value;

    /**
     * 私有构造函数，强制通过静态工厂方法创建
     */
    private function __construct(string $value)
    {
        // 核心逻辑：使用 TrimmedNonEmptyString 来处理和验证传入的字符串
        // 如果字符串在 trim 后为空，TrimmedNonEmptyString::fromString() 会抛出 InvalidArgumentException
        $this->value = TrimmedNonEmptyString::fromString($value)->toString();
    }

    /**
     * 静态工厂方法，用于从原始字符串创建 Name 值对象
     */
    public static function fromString(string $value): self
    {
        return new self($value);
    }

    /**
     * 获取内部存储的干净字符串
     */
    public function toString(): string
    {
        return $this->value;
    }

    // 可以在这里添加其他业务逻辑，例如比较两个 Name 对象是否相等
    public function equals(self $other): bool
    {
        return $this->value === $other->value;
    }
}

<pre class="brush:php;toolbar:false;">use App\Domain\Value\Name\Name;
use InvalidArgumentException;

try {
    // 有效的用户名
    $name1 = Name::fromString('  Alice  ');
    echo $name1->toString(); // 输出: Alice

    // 另一个有效的用户名
    $name2 = Name::fromString('Bob');
    echo $name2->toString(); // 输出: Bob

    // 尝试创建空用户名（会抛出异常）
    $emptyName = Name::fromString('   '); // 字符串在 trim 后为空
} catch (InvalidArgumentException $e) {
    echo "错误: " . $e->getMessage(); // 输出: 错误: String must not be empty.
}

try {
    // 尝试创建完全空字符串的用户名（会抛出异常）
    $nullName = Name::fromString('');
} catch (InvalidArgumentException $e) {
    echo "错误: " . $e->getMessage(); // 输出: 错误: String must not be empty.
}