Eloquent を使ったリレーション先の複数保存：saveMany() と createMany() の使い分け【Laravel】｜ブログ

はじめに Eloquent を使ったデータ保存の基本：save() と create() の使い分け【PHP/Laravel】 /blog/blog-1129/ 前回の記事では、Eloquentを使った単一データの保存（save() と create()）について解説しました。 実務でシステムを開発していると、「1回の注文（親データ）に対して、複数の購入商品明細（子データ）を紐付けて一度に保存したい」という場面があります。 今回は、このように関連する複数の子データをまとめて保存する際に利用する saveMany() と createMany() について、使い所を交えて解説します。 前提：注文（Order）と明細（OrderItem）の関係 一般的なECサイトの構造を例にします。 ユーザーが買い物をするとき、1回の「注文」に対して、カートの中には「商品A」や「商品B」といったように、複数の商品が入っている（購入する）ケースがあるかと思います。 このとき、データベースの内部では、1つの注文データ（親）に対して、複数の注文明細データ（子）が紐づく形で管理することができます。 このように、「1つのデータに対して、複数のデータが紐づいている関係」のことを、データベースの世界では「1対多のリレーション」 と呼びます。 php // app/Models/Order.php（注文モデル） class Order extends Model { // この注文に紐づく明細（複数）を取得する定義 public function items() { return $this->hasMany(OrderItem::class); } } リレーション経由で複数保存するメリット 注文データも注文明細データも、前回の save() や create() で1件ずつ保存することは可能です。 では、なぜリレーションを活用するのかというと、データ同士を紐づける「外部キー」が自動で補完される点にあります。 データベースで「注文」と「注文明細」を紐付けるためには、注文明細のデータ側に「これはどの注文の明細なのか」を記録するカラム（今回は orderid とします）を用意する必要があります。この、親データと紐付けるためのカラムを「外部キー」と呼びます。 通常であれば、明細を保存するたびに手動で 外部キーの設定を記述しなければなりませんが、リレーション経由のメソッドを使えば、Laravelが自動でこの外部キーの値を埋めて保存してくれます。 コードの記述量が減るだけでなく、代入漏れや指定ミスによるバグを未然に防ぎやすくなるのが大きなメリットです。 saveMany() と createMany() の使い分け saveMany() すでに「モデルのインスタンス」が複数生成されている場合に使用します。引数には、モデルインスタンスの配列を渡します。 php // 親となる注文を先に作成 $order = Order::create([...]); // 子となる明細データを作成 // インスタンスを作っただけであり、まだデータベースには保存されていません。 $items = [ new OrderItem(['productid' => 101, 'quantity' => 1]), new OrderItem(['productid' => 205, 'quantity' => 2]), ]; // まとめて保存 // この時、外部キー（orderid）はLaravelが自動で補完してくれます。 $order->items()->saveMany($items); 以下のように書く必要はありません。 php $order = Order::create([...]); $item1 = new OrderItem(['productid' => 101, 'quantity' => 1]); $item2 = new OrderItem(['productid' => 205, 'quantity' => 2]); // ❌️ わざわざ手動で外部キーを設定する $item1->orderid = $order->id; $item2->orderid = $order->id; // ❌️ 1件ずつ保存する $item1->save(); $item2->save(); ■使い所 今回の例のように、手元でいくつかデータ（インスタンス）を作って配列にまとめておき、最後にガサッと一度に保存したいときに最適です。 createMany() 手元にインスタンスはなく、画面から送られてきた複数のデータを、そのまま、もしくは整形したものをまとめて保存したい場合に使用します。 php // 親となる注文を先に作成 $order = Order::create([...]); // データベースに保存しやすいように用意したデータ $cartData = [ ['productid' => 101, 'quantity' => 1], ['productid' => 205, 'quantity' => 2], ]; // データをそのまま渡すだけで、複数の明細保存まで完了！ $order->items()->createMany($cartData); ■使い所 今回の例のように、複数の商品データをそのままあるいは自分で形を整えたデータがあるときに一気にデータベースへ保存したいときに最適です。 まとめ 今回は、関連する複数の子データをまとめて保存する saveMany() と createMany() について解説しました。 使い分けの基準を整理すると、以下のようになります。 saveMany() は、すでに手元にある 「インスタンスの配列」 を一度に保存したいとき createMany() は、画面から届いたデータを、「そのまま、あるいは整形した配列」 の状態で一度に保存したいとき どちらのメソッドを使っても、Laravelが裏側で「外部キー」の値を自動で補完してくれます。 実務の開発では、扱うデータの状態によって最適なメソッドが変わってきます。 その時々の状況に合わせて使い分けてください。