Laravel 中使用自定义主键和外键定义关联关系

laravel 中使用自定义主键和外键定义关联关系

在 Laravel 框架中,模型关联关系是构建复杂数据结构的关键。默认情况下,Laravel 假设表的主键是 id,并且外键遵循 表名_id 的命名规范。然而,在某些情况下,我们可能需要使用自定义的主键和外键。本文将详细介绍如何在 Laravel 中定义基于自定义主键和外键的一对一关联关系,并提供代码示例和注意事项。

正如本文摘要所说,我们将学习如何在使用非默认主键和外键时,在 Laravel 中正确定义模型关联关系。

数据库迁移修改

首先,我们需要修改数据库迁移文件,以创建正确的外键约束。假设我们有两个表:students 和 accounts,它们之间存在一对一的关系,并且我们使用 nik 字段作为 students 表的主键,并在 accounts 表中存储对应的外键。

以下是一个示例迁移文件:

use Illuminate/Database/Migrations/Migration;
use Illuminate/Database/Schema/Blueprint;
use Illuminate/Support/Facades/Schema;

class CreateAccountsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('accounts', function (Blueprint $table) {
            $table->id();
            $table->string('username');
            $table->string('password');
            $table->string('nik')->nullable(); // 将 nik 字段设置为 nullable
            $table->timestamps();

            $table->foreign('nik')->references('nik')->on('students')->onDelete('cascade'); // 添加外键约束,并设置级联删除
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('accounts');
    }
}

class CreateStudentsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('students', function (Blueprint $table) {
            $table->string('nik')->primary(); // 将 nik 字段设置为主键
            $table->string('name');
            $table->string('address');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('students');
    }
}
登录后复制

注意:

  • $table->string(‘nik’)->primary(); 将 nik 字段设置为主键。
  • $table->string(‘nik’)->nullable(); 在 accounts 表中将 nik 字段设置为可为空,因为可能存在尚未关联到任何学生的账户。
  • $table->foreign(‘nik’)->references(‘nik’)->on(‘students’)->onDelete(‘cascade’); 定义了外键约束,确保 accounts 表中的 nik 字段引用 students 表中的 nik 字段。onDelete(‘cascade’) 表示当 students 表中的记录被删除时,accounts 表中对应的记录也会被删除,以保持数据一致性。

模型关联定义

接下来,我们需要在模型中定义关联关系。

// Student Model (app/Models/Student.php)
namespace App/Models;

use Illuminate/Database/Eloquent/Factories/HasFactory;
use Illuminate/Database/Eloquent/Model;

class Student extends Model
{
    use HasFactory;

    protected $primaryKey = 'nik';
    public $incrementing = false;
    protected $keyType = 'string';

    public function account()
    {
        return $this->hasOne(Account::class, 'nik', 'nik');
    }
}

// Account Model (app/Models/Account.php)
namespace App/Models;

use Illuminate/Database/Eloquent/Factories/HasFactory;
use Illuminate/Database/Eloquent/Model;

class Account extends Model
{
    use HasFactory;

    public function student()
    {
        return $this->belongsTo(Student::class, 'nik', 'nik');
    }
}
登录后复制

解释:

  • 在 Student 模型中,我们设置了 $primaryKey = ‘nik’; 来指定 nik 字段作为主键。
  • public $incrementing = false; 由于 nik 不是自增的整数,我们需要将其设置为 false。
  • protected $keyType = ‘string’; 由于主键是字符串类型,我们设置 $keyType = ‘string’;。
  • $this->hasOne(Account::class, ‘nik’, ‘nik’); 在 Student 模型中,我们使用 hasOne 方法定义了一对一的关系。第一个参数是关联模型的类名,第二个参数是 Account 表中的外键,第三个参数是 Student 表中的本地键。
  • $this->belongsTo(Student::class, ‘nik’, ‘nik’); 在 Account 模型中,我们使用 belongsTo 方法定义了反向关系。参数含义与 hasOne 相同。

使用关联关系

现在,我们可以使用定义的关联关系来访问相关数据。

// 获取学生的账户信息
$student = Student::find('student123'); // 假设 'student123' 是一个存在的 nik
$account = $student->account;

if ($account) {
    echo "Student Username: " . $account->username;
} else {
    echo "No account found for this student.";
}

// 获取账户的学生信息
$account = Account::find(1); // 假设 1 是一个存在的 account id
$student = $account->student;

if ($student) {
    echo "Account Owner Name: " . $student->name;
} else {
    echo "No student found for this account.";
}
登录后复制

总结

通过以上步骤,我们成功地在 Laravel 中使用自定义主键和外键定义了一对一的关联关系。 关键在于正确配置数据库迁移文件,并明确指定模型中的主键、外键以及关联关系。 请务必根据实际情况调整字段名称和表名,并确保数据库中的外键约束与模型定义保持一致,从而保证数据的完整性和关联关系的正确性。 记住要设置 $primaryKey, $incrementing 和 $keyType 属性,以确保 Laravel 正确处理非默认主键。

以上就是Laravel 中使用自定义主键和外键定义关联关系的详细内容,更多请关注php中文网其它相关文章!

https://www.php.cn/faq/1464355.html

发表回复

Your email address will not be published. Required fields are marked *