この内容は古いバージョンです。最新バージョンを表示するには、戻るボタンを押してください。
バージョン:3
ページ更新者:atom
更新日時:2026-06-11 07:29:05

タイトル: Add [～] to fillable property to allow mass assignment on [App\～].
SEOタイトル: Add [～] to fillable property to allow mass assignment on [Ap

この記事の要点
  • Laravel の Add [field] to fillable property to allow mass assignment
  • 原因: Model::create([...]) 等のマスアサインメントで渡したカラムが $fillable に含まれていない
  • 対処: Model に protected $fillable = ['name', 'email', ...]; を追加
  • セキュリティ上重要: 想定外のカラムへの不正代入を防ぐための仕組み

 

エラー内容

Add [～] to fillable property to allow mass assignment on [App\～].

Laravelで Eloquent モデル経由でレコードを作成・更新するとき、Model::create([...]) や Model::fill([...]) のような マスアサインメント を行った際に出るエラーです。Eloquent は意図しないカラムへの一括代入を防ぐため、対象カラムを fillable プロパティで明示する必要があります。

発生条件

  • Model::create(['name' => '...', 'email' => '...']) のように、配列で複数カラムを渡して保存している
  • 渡したキーが、モデルの $fillable 配列に登録されていない
  • 同じく fill()、update()、firstOrCreate()、updateOrCreate() でも発生する

対処法

1. モデルに $fillable を追加（推奨）

マスアサインメントを許可するカラムをモデルに明記します。

// app/Models/User.php
class User extends Model
{
    protected $fillable = [
        'name',
        'email',
        'password',
    ];
}

エラーメッセージ Add [～] to fillable property の ～ がここに追加すべきカラム名です。

2. $guarded を使う書き方

逆に「これだけは一括代入を禁止する」スタイルもあります。空配列にすると全カラム許可になります。

protected $guarded = ['id'];
// または全カラムを許可（非推奨）
protected $guarded = [];

3. 1カラムずつ代入する（一時的）

急ぎで動かしたい場合、マスアサインメントを避ければエラーは出ません。

$user = new User();
$user->name = 'Taro';
$user->email = 'taro@example.com';
$user->save();

$fillable と $guarded の使い分け

プロパティ意味適している場面
$fillable許可するカラムのホワイトリストセキュリティ重視。基本これが推奨
$guarded許可しないカラムのブラックリストカラム数が多くて列挙が現実的でない場合

注意点

  • $guarded = [] はマスアサインメントを完全に開放する設定。ユーザー入力をそのまま create($request->all()) に渡す前にバリデーションでカラムを絞ること
  • 新規カラムを追加したら $fillable も更新するのを忘れない
  • id、created_at、updated_at は通常 $fillable に含めない