PHPライブラリを使い始める
項目一覧
Overview
MongoDB PHPライブラリは、 MongoDB PHP拡張機能の高レベルの抽象化であり、 MongoDBに接続し、配置に保存されているデータを操作するために使用できます。 このガイドでは、 MongoDB PHPライブラリを使用してMongoDB AtlasでホストされているMongoDBクラスターに接続し、クラスター内のデータをクエリするアプリケーションを作成する方法について説明します。
Tip
MongoDB Atlas は、MongoDB 配置をホストする完全管理のクラウドデータベース サービスです。このガイドの手順に従い、独自の無料(クレジット カード不要)MongoDB Atlas 配置を作成できます。
次のガイドに従って、サンプルPHPアプリケーションをMongoDB Atlas配置に接続します。 別のドライバーまたは プログラミング言語を使用してMongoDBに接続する場合は、 公式ドライバーのリストを参照してください。
ダウンロードとインストール
これらの手順を完了すると、新しいプロジェクトディレクトリ、新しいアプリケーションファイル、およびライブラリの依存関係がインストールされます。
MongoDB 配置の作成
MongoDB Atlas では無料階層の MongoDB 配置を作成して、データを保存および管理できます。 MongoDB Atlas は、MongoDB databaseをクラウドでホストおよび管理します。
Atlas で無料の MongoDB 配置を作成
Atlas の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプル データを新しい無料階層 MongoDB 配置にロードします。
これらの手順を完了すると、Atlas に新しい無料階層の MongoDB 配置が作成され、データベースユーザーの認証情報が作成され、データベースに サンプル データがロードされます 。
接続文字列の作成
MongoDB配置に接続するには、 接続string とも呼ばれる 接続 URIMongoDB を提供します。これは、 配置に接続する方法と接続中の動作をドライバーに指示します。
接続stringには、配置のホスト名またはIPアドレスとポート、認証メカニズム、ユーザー認証情報(該当する場合)、および接続オプションが含まれます。
MongoDB Atlas 接続文字列を見つける
前のステップ で作成した配置の接続文字列を取得するには、Atlas アカウントにログしてDatabase Connectセクションに移動し、新しい配置の [] ボタンをクリックします。

次に、 Select database user選択メニューからユーザーを選択します。 Driver選択メニューから「PHP」を選択し、 Version選択メニューからインストールしたバージョンに最適なバージョンを選択します。
接続stringのみを表示するには、Add connection string into your application code の手順で Stringタブを選択します。
これらの手順を完了すると、 クラスターに対応する接続string Atlasが作成されます。
サンプル クエリの実行
配置の接続string MongoDB Atlasを取得したら、 アプリケーションから配置に接続し、PHP Atlasサンプルデータセットをクエリできます。
PHPアプリケーションファイルを編集する
次のコードをコピーして、 quickstart.php
ファイルに貼り付けます。このコードは、 sample_mflix
データベース内のmovies
コレクションをクエリします。
require __DIR__ . '/../vendor/autoload.php'; use MongoDB\Client; $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
環境変数に割り当てられ、サンプルデータがロードされていることを確認してください。
これらの手順を完了すると、 MongoDBデプロイに接続し、サンプルデータに対してクエリを実行し、一致するドキュメントを返すPHPアプリケーションが作成されます。
次のステップ
クイック スタート チュートリアルを完了しました。
注意
このチュートリアルで問題が発生した場合は、 MongoDB Community フォーラム Rate this pageでサポートを依頼するか、このページの右側または右下にある タブを使用してフィードバックを送信してください。
このチュートリアルでは、 MongoDB AtlasでホストされているMongoDBデプロイに接続し、クエリに一致するドキュメントを検索するPHPアプリケーションを作成しました。
MongoDB PHPライブラリの詳細については、次のリソースを参照してください。
「 MongoDB へのデータの書込み」セクションで、書込み操作の実行方法を学びます。