0%

Programmingプログラミングナレッジ

Posted:2019.08.08

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

前回記事「Laravelでデータベースと連携したCRUDのAPIを作成してみる(環境構築) 」ではPHPのフレームワークであるLaravelでAPIを使ってデータベースと連携させるまでの準備についてまとめていました。今回は引き続き、データベースのデータを更新するためのAPIを作成していきたいと思います。

 

ここではCRUDの操作に合わせてそれぞれAPIを作成しています。基本的にはどれもroutesディレクトリ配下のapi.phpファイルにある、RouteクラスにそれぞれCRUDの操作に対応するメソッドを指定し、処理を記述していく形になります。

 

Read(データ取得)のAPI

まずはデータベースのデータを取得する操作のAPIになります。データを取得するにあたっては、全てのデータを一括して取得したり、条件に合わせて特定のデータに絞って取得することも可能です。

 

1. 全てのデータを取得する場合

全てのデータを一括して取得する場合はシンプルです。GETメソッドの中でall()関数を使うことでデータを全て取得することができます。Modelとなるクラスには対応するデータベースを指定したクラスを当て振ります。

【routes/api.php】※一部抜粋

use Illuminate\Http\Request;

Route::get("/read", function(){
 // Modelのクラスを指定
 return [
  "posts" => \App\Post::all()
 ];
});

 

ブラウザでAPIにアクセスし確認すると、データベースに入っている全てのデータがJSON形式で返されているのが確認できます。

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

 

2. ID指定で個別のデータを取得する

IDを指定し、そのIDを持つデータを拾ってくることも可能です。同じくGETメソッドでURLパスへのID指定と、コールバック関数にそのIDを引数に取ります。そしてwhere()関数で条件としてURLパスに入力されたIDを検知し、first()関数で条件に合うデータを1件取得する形になります。

【routes/api.php】※一部抜粋

use Illuminate\Http\Request;

Route::get("/read/{id}", function($id){
 return [
  "post" => \App\Post::where("id",$id)->first(),
 ];
});

 

こちらもブラウザで確認すると、指定したIDにマッチするデータが返されているのがわかります。URLには指定のIDがパスとして入っています。

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

 

3. IDで条件にあった複数のデータを取得する

条件に合う不特定多数のデータを取得する場合も同じく、where()関数で条件を指定する形になります。ここではIDが閾値以上のものを取得する例になります。複数のデータの時はget()を使うことで取得することができます。

【routes/api.php】※一部抜粋

use Illuminate\Http\Request;

Route::get("/reads", function(){
 return [
  "post" => \App\Post::where("id",">",1)->get()
 ];
});

 

同じくブラウザでも条件に合うデータを取得できているのが確認できました。

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

 

 

Create(データ登録)のAPI

次はAPIを通して値をデータベースのレコードに書き込むAPIを作成していきます。ここでは下記の通り、メソッドにPOSTを使うことになります。まずModelとなるクラスには対応するデータベースを指定したクラスを当て振ります。そしてデータに合わせてrequest()関数を使い、リクエストボディの値を取得し、そのままsave()関数でデータベースに値を登録します。

【routes/api.php】※一部抜粋

use Illuminate\Http\Request;

Route::post("/create", function(){
 $post = new \App\Post();
 $post->title = request()->get("title");
 $post->content = request()->get("content");
 $post->save();
 return [];
});

 

上記ではリクエストボディを経由して値をデータベースに書き込みます。「Postman」などのAPI開発ツールなどで下記のようにJSON形式でPOSTメソッドを使いAPIを叩きます。Postmanについて詳しくはこちらの記事「Postmanの導入で捗るAPI開発やデバッグ」にまとめていますのでご参考に。

POST http://127.0.0.1:8000/api/create

{
 "title": "追加の投稿タイトル",
 "content": "追加の投稿コンテンツ本文です。"
}

 

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

データベースの方を確認すると確かにリクエストボディに入れた値でレコードが書き込まれているのが確認できます。

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

 

 

Update(データ更新)のAPI

データの更新や変更などの操作はPATCHメソッドを使います。ここではIDを指定し、そのIDを持つデータに対して値の変更や更新を処理していきます。書き込みの時と同じく、リクエストボディ経由で値を更新していきます。ここでは更新対象のデータを指定する必要があるので、IDの値をURLパスと引数に取って対象のデータをfind()関数で探し出して指定しています。

Route::patch("/update/{id}", function($id){
 $post = \App\Post::find($id);
 if($post) {
  $post->title = request()->get("title");
  $post->content = request()->get("content");
  $post->save();
 }
 return [];
});

 

下記のようにPostmanを使って更新後の値を入れてAPIを叩きます。URLには対象のデータのIDを入れます。

PATCH http://127.0.0.1:8000/api/update/[ ID ]

{
 "title": "変更後の投稿タイトル",
 "content": "変更後の投稿コンテンツ本文です。"
}

 

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

データベースで確認するとレコードが変更されているのがわかります。

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

 

 

Delete(データ削除)のAPI

最後はデータの削除です。ここではデータベースのレコードを丸ごと削除する例をあげています。データの更新・変更の時と同じようにIDを指定し削除するデータを探します。処理自体はシンプルで、delete()関数で対象のデータをそのまま削除する形になります。

Route::delete("/delete/{id}", function($id){
 $post = \App\Post::find($id);
 if($post) {
  $post->delete();
 }
 return [];
});

 

下記のようにPostmanを使ってDELETEメソッドでAPIを叩きます。先ほどとは異なりリクエストボディには何も値を入れずにそのままAPIにアクセスします。同じくURLパスには対象のデータのIDを入れておきます。

DELETE http://127.0.0.1:8000/api/delete/[ ID ]

 

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

データベースの中では対象のレコードが削除されているのが確認できます。

Laravelでデータベースと連携したCRUDのAPIを作成してみる(API実装)

 


 

今回は基本的なCRUDの操作に対応したAPIのサンプルを作成してみました。実際のウェブアプリを開発する場合には、これらの処理をGUIで出来るようにフロント側も実装していく形になるかと思いますが、基本的な考え方としては同じようになります。Laravelではこのようにデータベースと連携したAPIも簡単に作れるのが人気の一つではないでしょうか。

author
この記事を書いた人オガワ シンヤ
FacebookTwitter

DesignSupply.代表 / ディレクター・ウェブデザイナー・フロントエンドエンジニアをやっています。「ウェブとデザインでヒト・モノ・サービスを繋げ新しい価値を生み出す」をコンセプトに日々奮闘中!制作中はチョコレートが欠かせない三十路Webクリエイター。

制作のご依頼やお問い合わせ・パートナー業務提携のご相談はこちら

デザインやウェブ制作についてのご依頼やご相談、その他お問い合わせなどもお気軽にご連絡ください。フットワークの軽さやレスポンスの早さ、また豊富な経験や知識、技術を活かした対応力といったフリーランスクリエイターの強みでクライアント様、パートナー企業様のお力になります。デザインからコーディングやWordPress実装といったウェブサイト構築はもちろん、写真撮影や動画編集、コンテンツ制作からサイト運用サポートまで一括してお任せください。

ホームページ制作のご検討やウェブ運用でお悩みの経営者様や企業のウェブ担当者様をはじめ、個人で店舗を営んでいらっしゃるオーナー様、フリーで活動されているビジネスオーナー様はもちろんのこと、リソース不足でお困りの制作会社様、またクリエイターをお探しの代理店様も大歓迎です。

コンタクトをご希望の方はお手数ですが、下記よりお問い合わせフォームのページへアクセスしていただき、必要事項を入力の上メッセージを送信してください。確認でき次第すぐに折り返しご連絡致します。

こんな記事も読まれています

コメントもお気軽にどうぞ

記事に関するご質問やご意見などありましたら下記のコメントフォームよりお気軽に投稿ください。なおメールアドレスは公開されませんのでご安心ください。また、* が付いている欄は必須項目となります。

内容に問題なければ、下記の「コメントを送信する」ボタンを押してください。

CAPTCHA


ページトップへ
大阪市天王寺区のホームページ制作デザイン事務所(SOHO)DesignSupply.【デザインサプライ】