Laravel Value Objects：为你的Laravel应用注入强类型力量

Laravel Value Objects：为你的Laravel应用注入强类型力量

laravel-value-objectsA bunch of general-purpose value objects you can use in your Laravel application.项目地址:https://gitcode.com/gh_mirrors/la/laravel-value-objects

项目介绍

在现代软件开发中，强类型和不可变性是提高代码质量和可维护性的关键因素。Laravel Value Objects 是一个专为 Laravel 应用设计的开源包，它提供了一系列通用的值对象（Value Objects），帮助开发者更好地管理和操作数据。无论是处理布尔值、数字、文本，还是更复杂的类字符串、电子邮件、电话号码等，这个包都能为你提供强类型的支持，减少错误，提高代码的可读性和可维护性。

项目技术分析

Laravel Value Objects 基于 PHP 8 和 Laravel 9 及以上版本开发，充分利用了 PHP 8 的新特性和 Laravel 的强大生态。该包的核心在于提供了一系列不可变的值对象，每个对象都封装了对特定类型数据的验证和操作逻辑。通过这些值对象，开发者可以在编译时捕获类型错误，避免在运行时出现意外的类型转换问题。

主要技术特点：

• 强类型支持：每个值对象都严格遵循其类型定义，确保数据的类型安全。
• 不可变性：值对象一旦创建，其值不可更改，确保数据的一致性和安全性。
• 丰富的内置值对象：包内提供了多种常见的值对象，如布尔值、数字、文本、电子邮件、电话号码等，满足大多数应用场景的需求。
• 可扩展性：支持通过 Artisan 命令生成自定义的值对象，并提供了宏（Macro）功能，方便开发者扩展和定制。

项目及技术应用场景

Laravel Value Objects 适用于各种需要强类型和不可变性的应用场景，特别是在以下情况下，它能够发挥巨大作用：

• 表单验证：在处理用户输入时，使用值对象可以确保输入数据的类型和格式正确，减少验证逻辑的复杂性。
• 数据传输对象（DTO）：在应用的不同层之间传递数据时，使用值对象可以确保数据的完整性和一致性。
• 领域驱动设计（DDD）：在复杂的业务逻辑中，值对象可以帮助你更好地建模和封装业务规则，提高代码的可维护性。
• API 开发：在构建 API 时，使用值对象可以确保返回的数据格式和类型符合预期，减少客户端的错误处理。

项目特点

1. 丰富的内置值对象

Laravel Value Objects 提供了多种常见的值对象，包括：

• Boolean：布尔值对象，支持从字符串、数字等类型转换为布尔值。
• Number：数字对象，支持高精度计算和本地化格式处理。
• Text：文本对象，封装了对字符串的操作。
• Email：电子邮件对象，确保电子邮件格式的正确性。
• Phone：电话号码对象，支持多种格式的电话号码处理。
• Uuid：UUID 对象，用于处理全局唯一标识符。

2. 自定义值对象生成

通过 Artisan 命令，你可以轻松生成自定义的值对象，满足特定业务需求：

php artisan make:value-object YourNameValueObject

3. 宏功能扩展

所有值对象都支持宏（Macro）功能，允许你在运行时动态添加新方法，扩展值对象的功能：

ValueObject::macro('str', function () {
    return str($this->value());
});

$name = new Text('Lorem ipsum');
$name->str()->is('Lorem ipsum'); // true

4. 条件处理

值对象使用了 Laravel 的 Conditionable 特性，支持 when 和 unless 方法，方便进行条件处理：

TaxNumber::from('PL0123456789')->when(function ($number) {
    return $number->prefix() !== null;
})->prefix();

5. 错误处理

为了避免在验证失败时捕获异常，你可以使用 makeOrNull 方法，直接返回 null：

$bool = Boolean::makeOrNull('bad input'); // null
$bool?->value(); // null

结语

Laravel Value Objects 是一个强大且灵活的工具，它为 Laravel 开发者提供了强类型和不可变性的支持，帮助你构建更安全、更可靠的应用。无论你是正在开发一个新的项目，还是希望改进现有代码的质量，这个包都值得一试。立即安装并体验 Laravel Value Objects 带来的便利吧！

composer require michael-rubel/laravel-value-objects

加入我们，一起为 Laravel 社区贡献更多高质量的开源项目！

laravel-value-objectsA bunch of general-purpose value objects you can use in your Laravel application.项目地址:https://gitcode.com/gh_mirrors/la/laravel-value-objects