MongoDB PHPライブラリを使い始める

依存関係をインストールします。

開発を開始する前に、ローカル マシンに次の依存関係がインストールされていることを確認してください。

• PHP バージョン 7.4 以降

• Composer バージョン 2.0 以降

• pie

MongoDB PHP拡張機能をインストールします。

次のコマンドを実行して、 mongodb PHP拡張機能をインストールします。

pie install mongodb/mongodb-extension

pie install mongodb/mongodb-extension:^2.1.8

プロジェクトディレクトリを作成します。

ルートディレクトリから、 shellで次のコマンドを実行して、このプロジェクト用に php-quickstart というディレクトリを作成します。

mkdir php-quickstart

オペレーティング システムに対応するタブを選択し、次のコマンドを実行して、 php-quickstartディレクトリにquickstart.phpアプリケーション ファイルを作成します。

cd php-quickstart
touch quickstart.php

cd php-quickstart
type nul > quickstart.php

MongoDB PHPライブラリをインストールします。

MongoDB PHPライブラリをインストールするには、 php-quickstartディレクトリで次のコマンドを実行します。

composer require mongodb/mongodb

ライブラリをインストールした後、次のコードをquickstart.phpファイルの先頭に追加して、Composer のautoload.phpファイルを含めます。

<?php
require_once __DIR__ . '/vendor/autoload.php';

Atlas に無料のMongoDB配置を作成します。

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

認証情報を保存します。

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

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

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

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

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

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

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

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

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

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

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

PHPアプリケーションファイルを編集します。

次のコードをコピーして、 quickstart.phpファイルに貼り付けます。このコードは、 sample_mflixデータベース内のmoviesコレクションをクエリします。

<?php
require __DIR__ . '/../vendor/autoload.php';
$uri = getenv('MONGODB_URI') ?: throw new RuntimeException(
    'Set the MONGODB_URI environment variable to your Atlas URI',
);
$client = new MongoDB\Client($uri);
$collection = $client->sample_mflix->movies;
$filter = ['title' => 'The Shawshank Redemption'];
$result = $collection->findOne($filter);
if ($result) {
    echo json_encode($result, JSON_PRETTY_PRINT);
} else {
    echo 'Document not found';
}

接続文字列を割り当てます。

MONGODB_URIこのガイドの「 接続文字列の作成 」ステップからコピーした接続文字列に、 環境変数を割り当てます。次のタブに示すように、 シェルコマンドを実行中か、アプリケーション内で .envファイルを作成することで、この変数を割り当てることができます。

export MONGODB_URI=<connection string>

MONGODB_URI=<connection string>

PHPアプリケーション を実行します。

プロジェクトディレクトリで、次shellコマンドを実行してアプリケーションを起動します。

php quickstart.php

コマンドライン出力には、検索された映画ドキュメントの詳細が含まれます。

{
    "_id": {
        "$oid": "..."
    },
    ...
   "rated": "R",
   "metacritic": 80,
   "title": "The Shawshank Redemption",
   ...
}

エラーが発生した場合や出力が表示されない場合は、適切な接続stringが MONGODB_URI 環境変数に割り当てられ、サンプルデータがロードされていることを確認してください。