{"id":943,"date":"2025-06-12T03:17:48","date_gmt":"2025-06-11T19:17:48","guid":{"rendered":"https:\/\/www.zhaozhao123.cn\/php\/php-application-manual\/laravel\/943.html"},"modified":"2025-06-12T03:17:48","modified_gmt":"2025-06-11T19:17:48","slug":"%e5%9c%a8laravel-eloquent%e4%b8%ad%e4%bd%bf%e7%94%a8uuid%e5%92%8culid","status":"publish","type":"my1js","link":"https:\/\/www.zhaozhao123.cn\/php\/my1js\/943.html","title":{"rendered":"\u5728Laravel Eloquent\u4e2d\u4f7f\u7528UUID\u548cULID"},"content":{"rendered":"
\r\n
\r\n
\r\n
\r\n
\r\n
\"Bug编译狮\"<\/figure>\r\n\r\n\r\n\r\n

Bug编译狮<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
\r\n
\r\n

在Laravel Eloquent中使用UUID（Universally Unique Identifier）和ULID（Universally Unique Lexicographically Sortable Identifier）是一种常见的做法，以确保数据库中的数据是唯一的，并且易于排序。以下是实现这两种方法的步骤：<\/p>\n

使用UUID<\/h3>\n
    \n
  1. \n

    安装uuid<\/code>包<\/strong>：\n首先，你需要安装uuid<\/code>包来生成UUID。<\/p>\n

    composer require uuid\/uuid<\/code><\/pre>\n<\/li>\n
  2. \n
    创建一个模型并使用UUID<\/strong>：\n创建一个新的Eloquent模型，并在其中使用UUID作为主键。<\/p>\n
    use IlluminateDatabaseEloquentModel;\nuse RamseyUuidUuid;\n\nclass User extends Model\n{\n   protected $primaryKey = 'uuid';\n   public $incrementing = false;\n\n   public function __construct(array $attributes = [])\n   {\n       parent::__construct($attributes);\n       $this->uuid = Uuid::uuid4();\n   }\n}<\/code><\/pre>\n<\/li>\n
  3. \n
    插入数据<\/strong>：\n当你尝试插入数据时，Laravel会自动为UUID字段赋值。<\/p>\n
    $user = new User();\n$user->save();\n\ndd($user->uuid); \/\/ 输出 UUID<\/code><\/pre>\n<\/li>\n<\/ol>\n
    使用ULID<\/h3>\n
      \n
    1. \n
      安装ulid<\/code>包<\/strong>：\n然后，你需要安装ulid<\/code>包来生成ULID。<\/p>\n
      composer require ulid\/ulid<\/code><\/pre>\n<\/li>\n
    2. \n
      创建一个模型并使用ULID<\/strong>：\n创建一个新的Eloquent模型，并在其中使用ULID作为主键。<\/p>\n
      use IlluminateDatabaseEloquentModel;\nuse UlidUlid;\n\nclass User extends Model\n{\n   protected $primaryKey = 'ulid';\n   public $incrementing = false;\n\n   public function __construct(array $attributes = [])\n   {\n       parent::__construct($attributes);\n       $this->ulid = Ulid::make();\n   }\n}<\/code><\/pre>\n<\/li>\n
    3. \n
      插入数据<\/strong>：\n当你尝试插入数据时，Laravel会自动为ULID字段赋值。<\/p>\n
      $user = new User();\n$user->save();\n\ndd($user->ulid); \/\/ 输出 ULID<\/code><\/pre>\n<\/li>\n<\/ol>\n
      示例代码<\/h3>\n
      以下是一个完整的示例，展示了如何在Laravel Eloquent中使用UUID和ULID。<\/p>\n
      use IlluminateDatabaseEloquentModel;\nuse RamseyUuidUuid;\nuse UlidUlid;\n\nclass User extends Model\n{\n    protected $primaryKey = 'uuid';\n    public $incrementing = false;\n\n    public function __construct(array $attributes = [])\n    {\n        parent::__construct($attributes);\n        $this->uuid = Uuid::uuid4();\n    }\n\n    public static function createWithUUID()\n    {\n        return self::create([\n            'name' => 'John Doe',\n            'email' => 'john.doe@example.com',\n        ]);\n    }\n\n    public static function createWithULID()\n    {\n        return self::create([\n            'name' => 'Jane Smith',\n            'email' => 'jane.smith@example.com',\n        ]);\n    }\n}\n\n\/\/ 插入数据\n$userWithUUID = User::createWithUUID();\n$userWithULID = User::createWithULID();\n\ndd($userWithUUID->uuid); \/\/ 输出 UUID\ndd($userWithULID->ulid); \/\/ 输出 ULID<\/code><\/pre>\n
      通过这种方式，你可以轻松地在Laravel Eloquent中使用UUID和ULID来确保数据库中的数据是唯一的，并且易于排序。<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>
      \r\n
      \r\n
      \r\n
      \r\n
      \r\n
      \"黑板Bug讲师\"<\/figure>\r\n\r\n\r\n\r\n
      黑板Bug讲师<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
      \r\n
      \r\n
      介绍<\/h2>
      在开发Web应用程序时，使用数据库记录的唯一标识符至关重要。传统上，数据库使用自动递增整数作为主键。然而，随着应用程序规模扩大和分布式系统的普及，需要更强大的解决方案来满足需求。进入UUID（全局唯一标识符）和ULID（全球唯一可排序标识符）。本教程将指导您如何在Laravel的Eloquent中使用UUID和ULIDs。<\/p>
      UUIDs, or Universally Unique Identifiers, are identifiers used to uniquely identify resources in a computer system. They are often used as part of the structure for network addresses and other unique identifier requirements. UUIDs are designed to be globally unique across different computing environments, making them suitable for use in various applications such as database records, software components, and distributed systems.<\/h3>
      UUID是一种用于唯一标识计算机系统中的信息的128位数字。生成两个UUID相同的概率极其低。UUID有不同版本；对于本教程的目的，我们将专注于版本4（随机）。<\/p>
      ULIDs, also known as Unified Local Identifiers, are a set of identifiers used to uniquely identify devices and services within local networks. They provide a standardized way for devices to communicate with each other without relying on external infrastructure such as the internet. ULIDs are commonly used in IoT (Internet of Things) applications where there is a need for secure and reliable communication between devices within a specific network.<\/h3>
      ULID是一种新的标识符，类似于UUID，但具有以下优点：例如，它可以进行字母排序，这意味着它们可以按创建时的顺序进行字母排序并保持升序排列。ULIDs在26个字符中编码，而UUID则有36个字符，因此对于存储来说更加紧凑。<\/p>
      设置 Laravel 并创建 Eloquent 模型。<\/h2>
      在深入实施UUID和ULIDs之前，请确保您已正确设置并运行Laravel项目。创建一个用于演示的Eloquent模型。<\/p>
      php artisan make:model Product<\/code><\/pre>
      这会创建一个新的模型，如果需要的话，还会生成一个迁移文件。<\/p>
      在Laravel的Eloquent ORM中使用UUIDs（通用唯一识别码）是一种常见的做法，可以提高数据的一致性和可读性。以下是如何在Laravel中实现这一点的基本步骤：\n\n首先，在config\/app.php文件中注册一个新服务提供者。\n\n‘providers’ => [\n \/\/ 其他服务提供者…\n AppProvidersAppServiceProvider::class,\n AppProvidersEventServiceProvider::class,\n AppProvidersRouteServiceProvider::class,\n\n AppProvidersDatabaseUuidServiceProvider::class, \/\/ 注册新的服务提供者\n],\n\n然后创建一个新的服务提供者类来处理UUIDs。\n\nnamespace AppProviders;\n\nuse IlluminateSupportFacadesSchema;\nuse IlluminateSupportServiceProvider;\nuse IlluminateSupportFacadesDB;\nuse IlluminateSupportFacadesSchemaBlueprint;\nuse IlluminateSupportFacadesSchemaBlueprint;\n\nclass DatabaseUuidServiceProvider extends ServiceProvider\n{\n public function boot()\n {\n Schema::defaultStringLength(191);\n\n DB::statement(‘CREATE TABLE IF NOT EXISTS uuid_table (id BIGINT AUTO_INCREMENT PRIMARY KEY, value VARCHAR(36))’);\n }\n\n public function register()\n {\n \/\/\n }\n}\n在这个例子中，我们定义了一个名为uuid_table的新表，该表包含两个字段：id和value。id字段是主键，value字段用于存储生成的UUID。\n\n在控制器或模型中使用UUID字段。\n\n例如，在控制器中：\nuse AppModelsUser;\n\n$user = User::find($id);\n$uuid = $user->id; \/\/ 获取用户ID对应的UUID\n或者在模型中：\nuse AppModelsUser;\n\nclass User extends Model\n{\n protected $table = ‘uuid_table’;\n}\n\n最后，确保数据库连接配置正确，并且有适当的权限来执行SQL语句。\n\n通过以上步骤，你可以轻松地在Laravel中使用UUIDs进行数据管理。这不仅可以帮助你更好地管理和维护数据，还可以提高系统的可靠性和性能。<\/h2>
      让我们先修改我们的新产品模型的迁移文件，使其使用UUID。<\/p>
      <?php\n\nuse IlluminateDatabaseMigrationsMigration;\nuse IlluminateDatabaseSchemaBlueprint;\nuse IlluminateSupportFacadesSchema;\n\nclass CreateProductsTable extends Migration\n{\n    public function up()\n    {\n        Schema::create('products', function (Blueprint $table) {\n            $table->uuid('id')->primary();\n            $table->string('name');\n            $table->timestamps();\n        });\n    }\n\n    public function down()\n    {\n        Schema::dropIfExists('products');\n    }\n}\n<\/code><\/pre>
      下一步，修改Eloquent模型以在创建时设置UUID：<\/p>
      <?php\n\nnamespace App;\n\nuse IlluminateDatabaseEloquentModel;\nuse IlluminateSupportStr;\n\nclass Product extends Model\n{\n    public $incrementing = false;\n    protected $keyType = 'string';\n\n    protected static function boot()\n    {\n        parent::boot();\n        static::creating(function ($model) {\n            if (empty($model->{{id}})) {\n                $model->{{id}} = Str::uuid();\n            }\n        });\n    }\n}\n<\/code><\/pre>
      创建控制器中的新产品时，它会自动获得一个UUID：<\/p>
      $product = Product::create(['name' => 'Example Product']);\n\/\/ $product->id would be a UUID like e.g., '123e4567-e89b-12d3-a456-426614174000'\n<\/code><\/pre>
      在Laravel的Eloquent模型中使用ULID（Universally Unique Lexicographical ID）。<\/h2>
      对于ULIDs，流程非常相似。修改迁移文件以期望字符串作为主键：<\/p>
      ...\n$table->string('id', 26)->primary();\n...\n<\/code><\/pre>
      在我们的产品模型中，我们将自动生成ULID：<\/p>
      use UlidUlid;\n\nprotected static function boot()\n{\n    parent::boot();\n    static::creating(function ($model) {\n        if (empty($model->{{id}})) {\n            $model->{{id}} = (string) Ulid::generate();\n        }\n    });\n}\n<\/code><\/pre>
      在控制器上创建一个新产品并观察ULID：<\/p>
      $product = Product::create(['name' => 'New Product']);\n\/\/ $product->id would be a ULID like e.g., '01F8MMBCVGACEVB4BC23T4HE6W'\n<\/code><\/pre>
      根据UUID和ULID查询。<\/h2>
      使用UUID或ULID查找记录与通过其他字段查询的方式一样简单：<\/p>
      $product = Product::find('01F8MMBCVGACEVB4BC23T4HE6W');\n\/\/ If exists, $product will contain the product with that ULID\n<\/code><\/pre>
      额外的担忧<\/h2>
      在使用UUID和ULID时，特别是在处理大型数据集的索引和性能方面可能会遇到问题。为了解决这些问题，可以考虑以下几点：<\/p>
      通过使用适当的数据库类型或为UUIDs启用二进制存储来优化索引。<\/p>
      如果需要根据创建时间排序，则使用UUID版本1。<\/p>
      高级示例<\/h2>
      创建一个自动生成的 Laravel 遍历表迁移，以便通过数据库引擎函数直接生成 ULIDs 或 UUID 作为主键，需要一些定制化。我将为您提供两种示例。请注意，不同数据库（如 MySQL、PostgreSQL 等）的数据库级别 UUID 或 ULID 生成可能依赖于特定的数据库类型，并且确保跨数据库兼容性可能需要基于数据库类型的条件逻辑。<\/p>
      UUIDs（通用唯一识别码）的例子。<\/h3>
      以下是为具有UUID主键的表创建迁移时，你可以如何操作。假设你的数据库引擎支持UUID。<\/p>
      use IlluminateDatabaseMigrationsMigration;\nuse IlluminateDatabaseSchemaBlueprint;\nuse IlluminateSupportFacadesSchema;\n\nclass CreateYourTableNameTable extends Migration\n{\n    public function up()\n    {\n        Schema::create('your_table_name', function (Blueprint $table) {\n            $table->uuid('id')->primary(); \/\/ Using UUID as primary key\n            $table->string('name');\n            \/\/ other fields...\n            $table->timestamps();\n        });\n    }\n\n    public function down()\n    {\n        Schema::dropIfExists('your_table_name');\n    }\n}\n<\/code><\/pre>
      ULIDs（Uniform Resource Locators）是一种用于唯一标识资源的系统，通常在互联网上使用。它们可以被用作URL、电子邮件地址或文件路径等。例如，一个典型的ULID可能看起来像这样：\nhttp:\/\/example.com\/resource\/unique-id-1234567890abcdefg<\/a>\nULIDs具有以下特点：\n\n唯一性：每个ULID都是唯一的。\n不可变性：一旦生成，就不能更改。\n易于存储和传输：由于它们通常是字符串格式，因此易于存储和传输。\n\nULIDs广泛应用于各种场景，如网站导航、电子商务、社交媒体以及数据管理等领域。<\/h3>
      对于ULIDs，由于大多数数据库没有内置的ULID功能，因此在处理时需要在应用程序代码中进行生成（例如，在模型的相应方法中）。creating<\/code>迁移设置如下：然而，这是ULID作为主键的基本迁移设置：<\/p>
      use IlluminateDatabaseMigrationsMigration;\nuse IlluminateDatabaseSchemaBlueprint;\nuse IlluminateSupportFacadesSchema;\n\nclass CreateYourTableNameTable extends Migration\n{\n    public function up()\n    {\n        Schema::create('your_table_name', function (Blueprint $table) {\n            $table->char('id', 26)->primary(); \/\/ ULID is 26 characters long\n            $table->string('name');\n            \/\/ other fields...\n            $table->timestamps();\n        });\n    }\n\n    public function down()\n    {\n        Schema::dropIfExists('your_table_name');\n    }\n}\n<\/code><\/pre>
      在您的Eloquent模型中，您会处理生成ULID：<\/p>
      use IlluminateDatabaseEloquentModel;\n\nclass YourModel extends Model\n{\n    public $incrementing = false;\n    protected $keyType = 'string';\n\n    protected static function boot()\n    {\n        parent::boot();\n\n        static::creating(function ($model) {\n            if (empty($model->{$model->getKeyName()})) {\n                $model->{$model->getKeyName()} = (string) UlidUlid::generate(); \/\/ Assuming you are using a ULID package\n            }\n        });\n    }\n}\n<\/code><\/pre>
      笔记<\/h3>
      性能考虑：使用UUID或ULIDs作为主键可能会对大型数据集产生影响。在这些标识符的索引和存储空间方面，需要进行考虑。<\/p>
      数据库特定功能：像PostgreSQL这样的数据库通常内置了UUID的支持，而其他如MySQL的数据库则会将UUID作为字符串处理。<\/p>
      跨数据库兼容性：如果需要确保跨数据库兼容性，建议在应用层生成UUID或ULID，而不是在数据库级别生成。<\/p>
      结论。<\/h2>
      综上所述，将UUID和ULID整合到Laravel Eloquent中可以提升分布式系统中唯一标识符的处理能力，促进扩展性，并确保冲突几乎不存在。<\/p><\/body>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>
      \r\n
      \r\n
      \r\n
      \r\n
      \r\n
      \"长工码奴1523\"<\/figure>\r\n\r\n\r\n\r\n
      长工码奴1523<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
      \r\n
      \r\n
      在 Laravel 5.4 中，你可以使用 UUID 和 ULID 做为数据库的主键。这些是两个不同的方法来生成随机字符串，但它们有一些共同点。<\/p>\n
      首先，让我们了解这两个术语：<\/p>\n
        \n
      • UUID<\/strong>：Universally Unique Identifier 是一种随机字符串，通常用于标识系统中的唯一实体。它由一系列十六进制数字组成，并且可以作为数据库的主键。<\/li>\n
      • ULID<\/strong>：Unique Local Identifier 是另一种随机字符串，通常用于标识本地系统中的唯一实体。它也由一系列十六进制数字组成，并且与 UUID 类似，但是它的范围比 UUID 更小（通常是 128 位），并且更常用于本地环境。<\/li>\n<\/ul>\n
        要使用这两种类型的字符串，你需要在你的模型类中定义一个名为 uuid<\/code> 或 ulid<\/code> 的属性。然后，在关联关系时，你可以将这两个字段传递给关联对象。以下是如何做到这一点的一个例子：<\/p>\n
        use IlluminateDatabaseEloquentModel;\n\nclass MyModel extends Model\n{\n    protected $table = 'my_table';\n\n    public function someRelatedField()\n    {\n        return $this->belongsTo(MyOtherModel::class);\n    }\n\n    \/\/ 添加 uuid 或 ulid 属性\n    public function setUuidAttribute($value)\n    {\n        $this->attributes['uuid'] = $value;\n    }\n}<\/code><\/pre>\n
        在这个例子中，我们创建了一个名为 MyModel<\/code> 的模型类，其中包含一个 someRelatedField<\/code> 关联器。这个关联器返回一个 MyOtherModel<\/code> 对象。我们还添加了两个方法：一个用于设置 uuid<\/code> 属性，另一个用于获取 uuid<\/code> 字段。<\/p>\n
        现在，假设我们有一个 MyOtherModel<\/code> 类，它有如下结构：<\/p>\n
        namespace AppModels;\n\nuse IlluminateDatabaseEloquentModel;\n\nclass MyOtherModel extends Model\n{\n    protected $table = 'my_other_table';\n\n    \/\/ 其他字段...\n}\n\n\/\/ 在 Laravel Eloquent 中，我们可以使用 setUuidAttribute 方法来设置 UUID 字段\npublic function setUuidAttribute($value)\n{\n    $this->attributes['uuid'] = $value;\n}<\/code><\/pre>\n
        这样，当我们在 setUuidAttribute<\/code> 方法中调用 $this->attributes['uuid'] = $value;<\/code> 时，Laravel 将自动将其转换为 UUID 字符串。这使得我们在关联关系中能够轻松地引用 UUID。<\/p>\n
        注意，如果你希望使用 ULID，那么你应该在关联关系的回调函数中传入一个参数，例如：<\/p>\n
        public function setUlidAttribute($value)\n{\n    $this->attributes['ulid'] = $value;\n}<\/code><\/pre>\n
        然后，在关联关系的回调函数中，你可以像这样调用 setUlidAttribute<\/code> 方法：<\/p>\n
        $relatedModel->setUlidAttribute($value);<\/code><\/pre>\n
        这样，你就可以在关联关系中引用 ULID 字符串了。<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\n","protected":false},"excerpt":{"rendered":"
        Bug编译狮 在Laravel Eloquent中使用UUID（Universally Unique Identifier）和ULID（Universally Uni..<\/p>\n","protected":false},"author":1,"featured_media":0,"menu_order":0,"template":"","meta":{"_acf_changed":false},"tags":[],"my1js2nav":[44],"tuisongtax":[],"class_list":["post-943","my1js","type-my1js","status-publish","hentry","my1js2nav-laravel"],"acf":{"qian_art_seotitle":"","qian_art_seotitle_source":{"label":"SEO\u6807\u9898","type":"text","formatted_value":""},"qian_art_seokws":"","qian_art_seokws_source":{"label":"SEO\u5173\u952e\u8bcd","type":"text","formatted_value":""},"qian_art_stzhong":"","qian_art_stzhong_source":{"label":"\u4e2d | \u77ed\u6807\u9898","type":"text","formatted_value":""}},"_links":{"self":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js\/943","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js"}],"about":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/types\/my1js"}],"author":[{"embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/media?parent=943"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tags?post=943"},{"taxonomy":"my1js2nav","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js2nav?post=943"},{"taxonomy":"tuisongtax","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tuisongtax?post=943"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}