LaravelModelUUID：如何轻松在Laravel中使用UUID

WBOY

发布时间：2025-06-18 15:52:28

585人浏览过

来源于php中文网

原创

在开发 Laravel 应用时，我经常需要使用 UUID 作为模型的主键或唯一标识符。手动生成和管理 UUID 既繁琐又容易出错。例如，需要确保生成的 UUID 的唯一性，并且正确地将 UUID 存储到数据库中，同时还要考虑到查询效率等问题。

dyrynda/laravel-model-uuid 这个包解决了这些问题，它提供了一种简单而有效的方式来在 laravel 模型中使用 uuid。通过使用这个包，你可以避免手动生成 uuid，并且可以轻松地将 uuid 集成到你的模型中。

Composer在线学习地址：学习地址

要使用 dyrynda/laravel-model-uuid，首先需要通过 Composer 安装它：

composer require dyrynda/laravel-model-uuid

安装完成后，只需在你的 Eloquent 模型中使用 Dyrynda\Database\Support\GeneratesUuid trait 即可：

默认情况下，该包会假设你的数据库表中有一个名为 uuid 的字段用于存储生成的 UUID 值。如果你想使用自定义的字段名，可以在你的模型中定义一个 uuidColumn 方法：
class Post extends Model
{
    public function uuidColumn(): string
    {
        return 'custom_column';
    }
}
你甚至可以在每个表中拥有多个 UUID 列，通过在 uuidColumns 方法中指定一个数组来实现。

							
								
								
									新快购物系统
									新快购物系统是集合目前网络所有购物系统为参考而开发，不管从速度还是安全我们都努力做到最好，此版虽为免费版但是功能齐全，无任何错误，特点有：专业的、全面的电子商务解决方案，使您可以轻松实现网上销售；自助式开放性的数据平台，为您提供充满个性化的设计空间；功能全面、操作简单的远程管理系统，让您在家中也可实现正常销售管理；严谨实用的全新商品数据库，便于查询搜索您的商品。
								
								下载 
							
						
该 trait 还提供了一个查询作用域，允许你根据 UUID 轻松查找记录：
// 使用默认的 (uuid) 列名查找特定的 post
$post = Post::whereUuid($uuid)->first();

// 使用自定义的列名查找特定的 post
$post = Post::whereUuid($uuid, 'custom_column')->first();
此外，如果你使用了 laravel-efficient-uuid 包，你还需要在你的模型中添加一个 cast，以正确地设置和检索你的 UUID 值。这将确保你的 UUID 以二进制形式写入你的 (MySQL) 数据库，并以字符串形式呈现。
 EfficientUuid::class,
    ];
}
总的来说，dyrynda/laravel-model-uuid 包极大地简化了在 Laravel 项目中使用 UUID 的过程。它提供了以下优势：


简化 UUID 生成： 自动生成 UUID，无需手动处理。

自定义灵活性： 允许自定义 UUID 字段名和版本。

便捷查询： 提供 whereUuid 查询作用域，方便根据 UUID 查找记录。

高效存储： 与 laravel-efficient-uuid 配合使用，可以优化 UUID 的存储和检索。

通过使用 dyrynda/laravel-model-uuid，你可以专注于业务逻辑的开发，而无需花费大量时间在 UUID 的生成和管理上。这不仅提高了开发效率，还降低了出错的风险。 在实际项目中，我使用这个包来管理用户、产品等模型的唯一标识符，极大地提高了开发效率和代码质量。