laravel使用uuid主键ID-白红宇的个人博客

laravel使用uuid主键ID

发布日期：2025-04-04 05:46:18 浏览次数：11 分类：精选文章

本文共 813 字，大约阅读时间需要 2 分钟。

使用Laravel主键作为UUID

在Laravel框架中，默认的主键类型是整数且自增。这可能会导致在处理大量数据时出现问题。为了避免这种情况，我决定将主键更改为UUID（通用唯一标识符）。以下是实现这一目标所需步骤：

模型配置

首先，你需要修改模型的主键属性。打开你的模型类，添加以下代码：

protected $keyType = 'string';
$increment = false;

这将确保主键字段使用字符串类型并且不会自增。

安装UUID扩展包

使用UUID生成字符串前，你需要一个扩展包。你可以通过以下命令安装：

composer require webpatser/laravel-uuid

这将安装所需的扩展包。

配置服务提供者

安装扩展包后，你需要在 kernel服务提供者中注册它，以便在应用中使用。打开 config/app.php，添加以下内容：

' Webpatser\Uuid\UuidProvider ',

这将允许你在应用中使用UUID相关功能。

生成UUID

在你的模型中，你可以通过以下方式生成UUID：

$post = new Post;
$post->id = \Webpatser\Uuid\Uuid::generate();
$post->save();

这将将_id_设置为一个字符串形式的UUID。

数据库迁移

在生产环境中，建议手动迁移现有数据库。由于主键已经被更改为字符串类型，你需要执行迁移命令：

php artisan migrate:fresh

确保所有迁移步骤都完成后，你的应用将正确工作。

通过以上步骤，你将能够在Laravel中为模型的主键使用字符串形式的UUID。这解决了自增整数的问题，并确保了数据在高负载情况下的正确性。

注意事项

上一篇：Laravel前后台+API路由分离架构（完善）

下一篇：Laravel从入门到精通：开启高效开发之旅

关于作者

喝酒易醉，品茶养心，人生如梦，品茶悟道，何以解忧？唯有杜康！

-- 愿君每日到此一游！