本文旨在帮助开发者解决在使用 Laravel 8 存储数据时，外键字段无法正确保存到数据库的问题。通过分析模型关联、表单提交和控制器逻辑，提供清晰的步骤和示例代码，确保外键关系的正确建立和数据持久化。
在 Laravel 8 中，正确地存储外键数据是构建关系型应用的关键。当尝试将关联数据（例如作者和类型）存储到书籍表中时，可能会遇到外键字段未被保存的问题。这通常是由于表单字段名称、模型关系定义或控制器处理不当引起的。以下提供详细的步骤和示例代码，以确保外键关系的正确建立和数据持久化。
1. 检查模型关系
首先，需要确保模型之间的关系已正确定义。在给定的例子中，Book 模型与 Author 和 Genre 模型之间存在 BelongsTo 关系，而 Author 和 Genre 模型与 Book 模型之间存在 hasMany 关系。这些关系定义了模型之间如何关联。
// Book Model
class Book extends Model
{
use HasFactory;
protected $fillable = [
'author_id',
'genre_id',
'title',
'blurb',
];
public function author()
{
return $this->belongsTo(Author::class);
}
public function genre()
{
return $this->belongsTo(Genre::class);
}
}
// Author Model
class Author extends Model
{
use HasFactory;
protected $fillable = [
'name',
];
public function books()
{
return $this->hasMany(Book::class);
}
}
// Genre Model
class Genre extends Model
{
use HasFactory;
protected $fillable = [
'title'
];
public function books()
{
return $this->hasMany(Book::class);
}
}注意: 确保 Book 模型中的关系方法名与表单字段名称相对应，或者在控制器中进行适当的转换。
2. 修改表单字段名称
这是最关键的一步。在 create.blade.php 视图文件中，需要修改 <select> 标签的 name 属性，将 authors[] 改为 author_id，将 genres[] 改为 genre_id。 这是因为数据库中 books 表的字段名为 author_id 和 genre_id。
<div>
<label class="" for="author">Author</label>
<select name="author_id">
@foreach($authors as $author)
<option value="{{ $author->id }}">{{ $author->name }}</option>
@endforeach
</select>
</div>
<div>
<label class="" for="genre">Genre</label>
<select name="genre_id">
@foreach($genres as $genre)
<option value="{{ $genre->id }}">{{ $genre->title }}</option>
@endforeach
</select>
</div>重要: 移除 []，因为只需要选择一个作者和一个类型，而不是多个。
3. 更新验证规则
在 BookController 的 store() 方法中，需要更新验证规则以匹配新的表单字段名称。
public function store(Request $request)
{
$validatedData = $request->validate([
'title' => 'required|max:255',
'author_id' => 'required|exists:authors,id', // 确保 author_id 存在于 authors 表的 id 列中
'genre_id' => 'required|exists:genres,id', // 确保 genre_id 存在于 genres 表的 id 列中
'blurb' => 'required',
]);
Book::create($validatedData);
return redirect()->route('admin.book.create');
}注意: 添加 exists 验证规则可以确保选择的 author_id 和 genre_id 确实存在于相应的表中。
4. 数据库迁移文件
确保数据库迁移文件中的外键约束正确设置。
public function up()
{
Schema::create('books', function (Blueprint $table) {
$table->id();
$table->foreignId('author_id')->constrained()->onDelete('cascade');
$table->foreignId('genre_id')->constrained()->onDelete('cascade');
$table->string('title');
$table->string('blurb');
$table->timestamps();
});
}->constrained() 会自动查找与 author_id 和 genre_id 对应的表（authors 和 genres），并创建外键约束。 ->onDelete('cascade') 表示当删除作者或类型时，与之关联的书籍也会被删除。
5. 简化数据创建
现在可以直接使用 $validatedData 创建 Book 模型，因为字段名称和数据库列名匹配。
Book::create($validatedData);
总结
通过以上步骤，可以解决 Laravel 8 中外键数据存储失败的问题。关键在于：
- 正确定义模型关系：确保模型之间的关联关系在模型类中正确配置。
- 匹配表单字段名称：表单字段的 name 属性应与数据库表中的列名一致。
- 更新验证规则：验证规则应与表单字段名称相匹配，并包含必要的存在性验证。
- 设置外键约束：在数据库迁移文件中，正确设置外键约束，以确保数据的完整性。
遵循这些步骤，可以确保在 Laravel 8 应用中正确存储和管理外键数据。
