{"id":983,"date":"2025-06-12T04:11:16","date_gmt":"2025-06-11T20:11:16","guid":{"rendered":"https:\/\/www.zhaozhao123.cn\/php\/php-application-manual\/laravel\/983.html"},"modified":"2025-06-12T04:11:16","modified_gmt":"2025-06-11T20:11:16","slug":"laravel-eloquent%ef%bc%9a%e5%a6%82%e4%bd%95%e6%b7%bb%e5%8a%a0%e5%94%af%e4%b8%80%e7%ba%a6%e6%9d%9f","status":"publish","type":"my1js","link":"https:\/\/www.zhaozhao123.cn\/php\/my1js\/983.html","title":{"rendered":"Laravel Eloquent\uff1a\u5982\u4f55\u6dfb\u52a0\u552f\u4e00\u7ea6\u675f"},"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 模型来定义表的结构，并添加唯一约束。以下是一个示例，展示了如何为模型中的字段添加唯一约束。<\/p>\n

假设我们有一个名为 User<\/code> 的模型，并且我们希望 email<\/code> 字段具有唯一性约束。<\/p>\n

    \n
  1. \n

    创建模型<\/strong>：\n首先，确保你已经安装了 Laravel，并且已经创建了一个项目。然后，创建一个新的模型：<\/p>\n

    php artisan make:model User<\/code><\/pre>\n<\/li>\n
  2. \n
    修改模型<\/strong>：\n打开 app\/User.php<\/code> 文件，找到 fillable<\/code> 属性，并添加 email<\/code> 字段到其中：<\/p>\n
    namespace App;\n\nuse IlluminateDatabaseEloquentModel;\n\nclass User extends Model\n{\n   protected $fillable = ['name', 'email'];\n}<\/code><\/pre>\n<\/li>\n
  3. \n
    添加唯一约束<\/strong>：\n为了确保 email<\/code> 字段具有唯一性约束，你需要在数据库迁移文件中添加这个约束。首先，运行以下命令生成迁移文件：<\/p>\n
    php artisan make:migration add_unique_email_to_users_table --create users<\/code><\/pre>\n
    然后打开生成的迁移文件 database\/migrations\/xxxx_xx_xx_xxxxxx_add_unique_email_to_users_table.php<\/code>，并添加以下代码：<\/p>\n
    use IlluminateDatabaseMigrationsMigration;\nuse IlluminateDatabaseSchemaBlueprint;\nuse IlluminateSupportFacadesSchema;\n\nclass AddUniqueEmailToUsersTable extends Migration\n{\n   public function up()\n   {\n       Schema::table('users', function (Blueprint $table) {\n           $table->unique('email');\n       });\n   }\n\n   public function down()\n   {\n       Schema::table('users', function (Blueprint $table) {\n           $table->dropUnique('email');\n       });\n   }\n}<\/code><\/pre>\n<\/li>\n
  4. \n
    运行迁移<\/strong>：\n运行迁移以应用唯一约束：<\/p>\n
    php artisan migrate<\/code><\/pre>\n<\/li>\n
  5. \n
    验证唯一约束<\/strong>：\n你可以通过尝试插入重复的电子邮件来验证唯一约束是否生效。例如，如果你试图插入一个已经存在的电子邮件，Laravel 会抛出异常：<\/p>\n
    $user = new User();\n$user->name = 'John Doe';\n$user->email = 'john.doe@example.com'; \/\/ 这个电子邮件已经存在\n\ntry {\n   $user->save();\n} catch (IlluminateDatabaseQueryException $e) {\n   echo $e->getMessage(); \/\/ 输出: Duplicate entry for key 'email'\n}<\/code><\/pre>\n<\/li>\n<\/ol>\n
    通过以上步骤，你可以在 Laravel 中为模型中的字段添加唯一约束。<\/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>
    Laravel的Eloquent ORM提供了对数据库进行简单Active Record实现的功能。在处理关系型数据库时，唯一约束（UNIQUE）对于确保数据完整性非常重要，可以通过避免特定列或组合列上的重复值来实现这一目标。在这篇教程中，我们将通过使用迁移和模型事件的方法，向Laravel模型添加唯一约束。<\/p>
    理解唯一约束（UNIQUE Constraint）<\/h3>
    一个唯一约束确保表中的每一行的某一列或一组列的值都是唯一的。这有助于维护数据完整性和可以提高搜索性能，从而减少重复项。<\/p>
    使用迁移添加唯一约束<\/h2>
    在Laravel中，迁移是PHP类，用于帮助您随着时间管理数据库模式的变化。要添加一个唯一约束，请创建一个新的迁移或修改现有的一个。<\/p>
    创建一个新的迁移操作。<\/h3>
    为了为添加唯一约束创建一个新的迁移，你可以运行以下 Artisan 命令：<\/p>
    php artisan make:migration add_unique_constraint_to_users_table --table=users\n<\/code><\/pre>
    该命令会生成一个迁移文件在。database\/migrations<\/code>目录。打开生成的文件，然后在其中。up<\/code>方法，使用它。unique<\/code>在schema构建器上方法：<\/p>
    public function up()\n{\n    Schema::table('users', function (Blueprint $table) {\n        $table->string('email')->unique();\n    });\n}\n<\/code><\/pre>
    这段代码片段为表添加了一个唯一约束。email<\/code>对不起，我无法理解这句话的含义，请您重新描述您的问题或提供更多的上下文信息。users<\/code>表格。要应用迁移，请运行：<\/p>
    php artisan migrate\n<\/code><\/pre>
    上述命令会修改表并添加唯一约束。请注意，如果该列的表中已经存在重复值，则迁移过程将失败，并且您需要在应用唯一约束之前解决这些重复值。<\/p>
    修改现有迁移操作<\/h3>
    如果你更倾向于修改现有的迁移而不是创建一个新的，可以在迁移中直接添加唯一索引。up<\/code>该迁移的方法，就像上一个例子一样：<\/p>
    public function up()\n{\n    \/\/ ... existing columns\n\n    $table->string('username')->unique();\n}\n<\/code><\/pre>
    这将为表添加一个唯一约束。username<\/code>栏目。<\/p>
    在多个列上创建唯一索引。<\/h2>
    您可以传递一个数组来强制在多个列上实现唯一性。unique<\/code>方法：<\/p>
    public function up()\n{\n    Schema::table('orders', function (Blueprint $table) {\n        $table->unique(['user_id', 'product_id']);\n    });\n}\n<\/code><\/pre>
    这将会创建一个复合的唯一索引在上。user_id<\/code>and 是“并且”的意思。product_id<\/code>列，确保每个用户只能有一个订单对应一个产品。<\/p>
    自定义索引名称和删除索引<\/h2>
    你可以通过传递第二个参数来指定自定义索引名称。unique<\/code>方法：<\/p>
    $table->string('email')->unique('custom_email_unique');\n<\/code><\/pre>
    要删除一个唯一约束\/索引，您需要指定其名称：<\/p>
    $table->dropUnique('custom_email_unique');<\/code><\/pre>
    使用模型事件来强制执行唯一性约束<\/h2>
    另一种防止重复记录的方法是在应用程序级别使用模型事件来强制执行唯一性：<\/p>
    class User extends Model\n{\n    protected static function boot()\n    {\n        parent::boot();\n\n        static::creating(function ($user) {\n            if (User::where('email', $user->email)->exists()) {\n                throw new \\[Exception('Email already exists.');\n            }\n    });\n}\n<\/code><\/pre>
    这个片段会检查给定电子邮件的用户是否已经存在，然后再创建新的用户。但是，请注意，这种方法容易受到竞态条件的影响，并不应被用作数据库级别的唯一约束来替代。<\/p>
    处理重复数据<\/h2>
    在添加唯一约束之前，您应该解决任何现有重复数据的问题。这里有一个示例来清理重复的电子邮件：<\/p>
    User::groupBy('email')->havingRaw('COUNT(*) > 1')->get()->each(function ($user) {\n    User::where('email', $user->email)->orderBy('id')->skip(1)->take(PHP_INT_MAX)->delete();\n});\n<\/code><\/pre>
    这会保留第一次出现的条目，删除后续的重复条目。完成清理后，你可以安全地添加唯一约束。<\/p>
    处理唯一约束违反的情况。<\/h2>
    当出现UNIQUE约束违反时，Laravel会抛出一个异常。IlluminateDatabaseQueryException<\/code>你可以捕获这个异常来优雅地处理重复项：<\/p>
    try {\n    \/\/ Code that might violate unique constraint\n} catch (\\[Illuminate\\Database\\QueryException $exception) {\n    if ($exception->errorInfo[1] == 1062) {\n        \/\/ Handle the duplicate key error\n    }\n}\n<\/code><\/pre>
    注意，错误代码1062对应于MySQL中的唯一约束的重复条目。这可能因数据库系统而异。<\/p>
    结论。<\/h2>
    总结来说，Laravel的Eloquent ORM和Schema Builder提供了管理数据库模式中的唯一约束的简单方法。无论是创建新的迁移还是修改现有的一个，添加或删除唯一索引来维护数据完整性和性能都很容易。虽然模型事件提供了一种在应用程序级别处理重复项的方法，但没有任何东西能替代数据库级约束的强大性和保证性。<\/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 的 Eloquent 模型中，你可以使用 unique<\/code> 关键字来定义唯一约束。以下是如何创建一个唯一的邮箱字段：<\/p>\n
    use IlluminateSupportFacadesDB;\n\nclass User extends Model {\n    protected $table = 'users';\n\n    public function validate()\n    {\n        return [\n            'email' => ['required', 'string', 'email', 'unique:users,email'],\n        ];\n    }\n}<\/code><\/pre>\n
    在这个例子中，我们为 User<\/code> 类的 email<\/code> 字段设置了 unique<\/code> 限制。这意味着当用户尝试插入一个新的电子邮件时，如果该电子邮件已存在，则将抛出异常。<\/p>\n
    如果你想要更具体的帮助，请告诉我你在特定情况下遇到的问题或者需要什么样的信息。<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\n","protected":false},"excerpt":{"rendered":"
    Bug编译狮 在 Laravel 中，你可以使用 Eloquent 模型来定义表&..<\/p>\n","protected":false},"author":1,"featured_media":0,"menu_order":0,"template":"","meta":{"_acf_changed":false},"tags":[],"my1js2nav":[44],"tuisongtax":[],"class_list":["post-983","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\/983","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=983"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tags?post=983"},{"taxonomy":"my1js2nav","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js2nav?post=983"},{"taxonomy":"tuisongtax","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tuisongtax?post=983"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}