Eloquent を使ったデータ保存の基本：save() と create() の使い分け【PHP/Laravel】｜ブログ

はじめに Eloquent を使ったデータ取得のあれこれ【PHP/Laravel】 /blog/blog-952/ 以前、筆者はLaravelのEloquentを使った「データ取得」について取り上げました。 今回は、データの「保存」について解説します。 Laravelにはデータを保存する方法がいくつかありますが、今回は最も基本となる save() と create() に焦点を当てます。「どう使い分けるべきか」という視点で、実務での活用イメージを掴んでいただければ幸いです。 前提 MySQLなどのDBを利用し、モデルクラス（例：Product）が作成済みであることを前提とします。 また、主キー（id）は AUTOINCREMENT が付与されているものとします。 Eloquentモデルを使ったの保存 save() Laravelで最も基本的かつ柔軟な保存メソッドです。 「インスタンスを作って、値をセットして、保存する」という直感的な手順を踏みます。 // 新規で作成されたモデルから行ったの場合はinsert $product = new Product(); $product->name = '商品A'; $product->price = 5000; // name='商品A', price=5000 としてデータが作成される $product->save(); // 既存のモデルから行った場合はupdate $product = Product::find(1); $product->name = '商品B'; $product->price = 3000; // ID=1 のデータが、name='商品B', price=3000 として更新され $product->save(); 特徴：新規作成か更新かをLaravelが自動で判断してくれる。 メリット：保存前に条件分岐を入れたり、特定のプロパティだけを書き換えたりする際に制御がしやすい。 複数の値をまとめてセットしたい場合は fill() メソッドを組み合わせるとコードがスッキリします。 $product->fill(['name' => '商品', 'price' => 5000])->save(); create() 新規作成に特化したメソッドです。モデルのインスタンス化を意識せず、1行で記述できるのが魅力です。 // name='商品', price=5000 のデータが新規作成される $product = Product::create([ 'name' => '商品', 'price' => 5000, ]); 特徴：返り値は、作成されたモデルのインスタンスとなる。 メリット：記述が非常にシンプル。後述する「複数代入」を利用するため、フォームからのリクエスト（$request->all()など）をそのまま流し込めるため便利。 Mass Assignment（複数代入）と $fillable ここで一つ、注意点があります。 create() や fill() を使う場合、モデルクラス側で「どのカラムへの入力を許可するか」を明示する必要があります。これを Mass Assignment（複数代入）対策 と呼びます。 Laravelではデフォルトだと、全てのカラムへの入力が許可されていない状態となっています。 これは意図しないカラムを外部から書き換えられないようにするためのセキュリティ機能です。 モデルクラスで $fillable プロパティにカラム名を設定することで入力が許可されます。 // app/Models/Product.php class Product extends Model { // 保存を許可するカラムを指定 protected $fillable = ['name', 'price']; } これがないと、create()やfill()を実行してもデータが正しく保存されません。 まとめ save() は、インスタンスを操作しているときに、そのまま柔軟に扱える。 create() は、新規データに特化していて記述がシンプルに作れる。 以上のような特徴がありますので、状況に応じて使い分けてみてください。 さて、今回は「単一のデータ」を扱う方法を紹介しましたが、実務では「親データと一緒に、複数の子データを一気に保存したい」という場面がよくあります。 次回は、リレーションを活用した保存メソッド（saveMany や createMany）について詳しく解説したいと思います。