Lambda MongoDBを使い始める

MongoDB PHP 拡張機能のインストール

Lambda MongoDBでは、 MongoDB の接続とコマンドを管理するためにMongoDB PHP拡張機能が必要です。MongoDB PHP拡張機能をインストールする方法については、 PHPライブラリガイドの「 MongoDB PHP拡張機能のインストール 」のステップを参照してください。

Lambda のインストール

インストールする Lambda のバージョンが Lambda 統合のバージョンと互換性があることを確認します。互換性のあるバージョンについては、互換性ページを参照してください。

Lambda をインストールするには、以下のコマンドを実行します。

composer global require laravel/installer

インストールが完了すると、 コマンドは次のメッセージを出力します。

Using version ^<version number> for laravel/installer

Lambda アプリケーションの作成

次のコマンドを実行して、 my-appという新しい Lambda ウェブ アプリケーションを生成します。

laravel new my-app

インストールが完了すると、 コマンドは次のメッセージを出力します。

INFO  Application ready in [my-app]. You can
start your local development using:
➜ cd my-app
➜ php artisan serve
New to Laravel? Check out our bootcamp and documentation.
Build something amazing!

Lambda アプリケーション暗号化キーの追加

前の手順で作成したアプリケーション ディレクトリに移動します。

cd my-app

次のコマンドを実行して、クッキーを暗号化するのに必要な Lambda アプリケーション暗号化キーを追加します。

php artisan key:generate

Lambda MongoDB を依存関係に追加する

次のコマンドを実行して、Larevel MongoDB の依存関係をアプリケーションに追加します。

composer require mongodb/laravel-mongodb:^5.8

インストールが完了したら、 composer.jsonファイルのrequireオブジェクトに次の行が含まれていることを確認します。

"mongodb/laravel-mongodb": "^5.8"

これらの手順を完了すると、Laravel 統合の依存関係がインストールされた新しい Lambel プロジェクトが作成されます。

Atlas で無料の MongoDB 配置を作成

MongoDB の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプルデータを新しい無料階層の MongoDB 配置にロードします。Cloud Deployment タブの手順に従って、クラウドにMongoDB Atlas の配置を作成します。

認証情報を保存する

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

MongoDB Atlas接続文字列を見つけます。

前のステップで作成した配置の接続文字列を取得するには、Atlas アカウントにログインし、Clusters セクションの下の Database ページに移動します。新しい配置で Connect ボタンをクリックします。

データベースユーザーをまだ設定していない場合、 MongoDB は新しいユーザーを作成して設定するように要求します。

Connect to your application の下の [Drivers ボタンをクリックし、Driver 選択メニューから「PHP」を選択し、Version 選択メニューからインストールしたバージョンに最適なバージョンを選択します。

接続文字列のみを表示するには、View full code sample オプションが選択されていないことを確認します。

接続文字列をコピーします。

次のスクリーンショットに示すように、接続stringの右側にあるコピーアイコンをクリックして、クリップボードにコピーします。

パスワード プレースホルダーを更新します。

この接続文字列をテキストエディタのファイルに貼り付け、<db_password> プレースホルダーをデータベースユーザーのパスワードに置き換えます。接続文字列には、すでにデータベースユーザーのユーザー名が入力されています。

このファイルを安全な場所に保存して、次の手順で使用します。

アプリケーション環境変数ファイルを構成する

次の shell コマンドを実行して、 .env.exampleファイルをプロジェクト ルート ディレクトリ内の.envという名前のファイルにコピーします。

cp .env.example .env

.envファイルを開き、次の変数と値を追加または編集します。<connection string> プレースホルダーを 接続文字列の作成 ステップの接続文字列に置き換えます。

DB_CONNECTION=mongodb
DB_URI="<connection string>"

たとえば、接続stringが "mongodb+srv://myUser:myPass123@mongo0.example.com/" の場合、DB_URI 変数は次の行と一致します。

DB_URI="mongodb+srv://myUser:myPass123@mongo0.example.com/"

データベース構成で接続stringを設定する

configディレクトリ内のdatabase.phpファイルを開き、次の行に示すように、 DB_CONNECTION環境変数へのデフォルトのデータベース接続を設定します。

'default' => env('DB_CONNECTION'),

次のハイライトされているmongodbエントリを同じファイル内のconnections配列に追加します。

'connections' => [
  'mongodb' => [
    'driver' => 'mongodb',
    'dsn' => env('DB_URI'),
    'database' => 'sample_mflix',
  ],
],
// ...

Lambda 統合プロバイダーを追加する

bootstrapディレクトリ内のproviders.phpファイルを開き、次のエントリを 配列に追加します。

MongoDB\Laravel\MongoDBServiceProvider::class,

モデルとコントローラーを作成する

MongoDB database 内のサンプルmoviesコレクションのデータを表すために、 Movieというモデルと対応するリソース コントローラーを次のコマンドで実行して作成します。

php artisan make:model Movie -cr

コマンドが完了すると、次のメッセージが出力されます。

INFO  Model [app/Models/Movie.php] created successfully.
INFO  Controller [app/Http/Controllers/MovieController.php]
created successfully.

Lambda 統合を使用するようにモデルを編集する

app/ModelsディレクトリでMovie.phpモデルを開き、次の編集を行います。

• Illuminate\Database\Eloquent\ModelインポートをMongoDB\Laravel\Eloquent\Modelに置き換え

• $connectionフィールドに"mongodb"を指定する

編集されたMovie.phpファイルには、次のコードが含まれています。

<?php
namespace App\Models;
use MongoDB\Laravel\Eloquent\Model;
class Movie extends Model
{
    protected $connection = 'mongodb';
}

コントローラー関数を追加する

app/Http/ControllersディレクトリでMovieController.phpファイルを開きます。 show()関数を次のコードで置き換えると、データベース クエリに一致する結果が検索され、それが ビューでレンダリングされます。

public function show()
{
    return view('browse_movies', [
        'movies' => Movie::where('runtime', '<', 60)
            ->where('imdb.rating', '>', 8.5)
            ->orderBy('imdb.rating', 'desc')
            ->take(10)
            ->get()
    ]);
}

Web ルートを追加する

routesディレクトリでweb.phpファイルを開きます。 次のコードに示すように、 MovieControllerとbrowse_moviesというルートのインポートを追加します。

<?php
// ...
use App\Http\Controllers\MovieController;
Route::get('/browse_movies/', [MovieController::class, 'show']);

ビューの生成

アプリケーション ルート ディレクトリから次のコマンドを実行して、映画データを表示するビューを作成します。

php artisan make:view browse_movies

コマンドを実行すると、次のメッセージが出力されます。

INFO  View [resources/views/browse_movies.blade.php] created
successfully.

resources/viewsディレクトリでbrowse_movies.blade.phpビューファイルを開きます。 内容を次のコードで置き換え、変更を保存します。

<!DOCTYPE html>
<html>
<head>
   <title>Browse Movies</title>
</head>
<body>
<h2>Movies</h2>
@forelse ($movies as $movie)
  <p>
    Title: {{ $movie->title }}<br>
    Year: {{ $movie->year }}<br>
    Runtime: {{ $movie->runtime }}<br>
    IMDB Rating: {{ $movie->imdb['rating'] }}<br>
    IMDB Votes: {{ $movie->imdb['votes'] }}<br>
    Plot: {{ $movie->plot }}<br>
  </p>
@empty
    <p>No results</p>
@endforelse
</body>
</html>

オプションで、結果を JSON ドキュメントとして表示します

ビューを生成してbrowse_movies.blade.phpファイルを編集する代わりに、 toJson()メソッドを使用して結果を JSON 形式で表示できます。

結果を検索し、JSON ドキュメントとして返すには、 show()関数を次のコードで置き換えます。

public function show()
{
    $results = Movie::where('runtime', '<', 60)
        ->where('imdb.rating', '>', 8.5)
        ->orderBy('imdb.rating', 'desc')
        ->take(10)
        ->get();
    return $results->toJson();
}

Lambda アプリケーションを起動する

PHP 組み込みウェブ サーバーを起動するには、アプリケーション ルート ディレクトリから次のコマンドを実行します。

php artisan serve

サーバーが起動すると、次のメッセージが出力されます。

INFO  Server running on [http://127.0.0.1:8000].
Press Ctrl+C to stop the server

映画データを表示する

ウェブ ブラウザでURL http://:127.0.0.1 8000/browse_movies を開きます。ページには、映画のリストとそれぞれの詳細が表示されます。

データを挿入するための関数を実装する

次のコードで、 app/Http/ControllersディレクトリにあるMovieController.phpファイル内のstore()メソッドを置き換えます。

public function store(Request $request)
{
    $data = $request->all();
    $movie = new Movie();
    $movie->fill($data);
    $movie->save();
}

コントローラー関数を呼び出す API ルートを追加する

次のコマンドを実行して API ルート ファイルを生成します。

php artisan install:api

コントローラーをインポートし、 routes/api.phpファイルにstore()メソッドを呼び出す API ルートを追加します。

use App\Http\Controllers\MovieController;
// ...
Route::resource('movies', MovieController::class)->only([
    'store'
]);

モデル フィールドを更新します

次のコードに示すように、 app/Modelsディレクトリ内のMovieモデルを更新して、 fill()メソッドが入力するフィールドを指定します。

class Movie extends Model
{
     protected $connection = 'mongodb';
     protected $fillable = ['title', 'year', 'runtime',
         'imdb', 'plot'];
}

API にリクエストを投稿する

movie.jsonというファイルを作成し、次のデータを挿入します。

{
  "title": "The Laravel MongoDB Quick Start",
  "year": 2024,
  "runtime": 15,
  "imdb": {
    "rating": 9.5,
    "votes": 1
  },
  "plot": "This movie entry was created by running through
      the Laravel MongoDB Quick Start tutorial."
}

shell で次のコマンドを実行して、JSON ペイロードをPOSTリクエストとしてエンドポイントに送信します。

curl -H "Content-Type: application/json" \
  --data @movie.json \
  http://localhost:8000/api/movies

データを表示

ウェブ ブラウザで http://:127.0.0.1 8000/browse_movies を開き、送信した映画情報を表示します。挿入された映画は、結果の上部に表示されます。