MongoDB PHPドライバー

はじめに

公式 MongoDB PHP ドライバーのドキュメント サイトへようこそ。アプリケーションにドライバーを追加して、PHP で MongoDB を操作できます。MongoDB PHP ドライバーは次のコンポーネントで構成されています。

• 拡張機能 : 低レベルAPIを提供し、主に libmongoc ライブラリと libbson ライブラリをPHPと統合するために使用されます。

• ライブラリ : 他のMongoDB言語ドライバーと整合性のあるMongoDBデータベースを操作するための高レベルのAPIを提供します。

拡張機能のみを使用することも可能ですが、拡張機能とライブラリを併用することをお勧めします。 PHPドライバーのコンポーネントの詳細については、このページの「 ドライバーのアーキテクチャ 」セクションを参照してください。

ドライバーについて詳しく学んだり、実行可能なプロジェクトをセットアップするに関するチュートリアル コンテンツにアクセスするには、次のガイドを表示します。

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

• MongoDB に接続する

ドライバーのアーキテクチャ

このセクションでは、PHP ドライバーのコンポーネント同士がどのように連携するかについて説明します。これらのコンポーネントは、次の一般的なカテゴリに分類されます。

• 高レベル API（ライブラリとその他の統合を含む）

• 拡張（システム ライブラリを統合する拡張機能を含む）

• システム（C ドライバー、BSON ライブラリ、暗号化ライブラリを含む）

次の図は、PHP ドライバー コンポーネントのアーキテクチャを示します。

PHP ライブラリは、他の MongoDB ドライバーと整合性のある API を提供します。ライブラリは、クロスドライバー仕様を満たすために継続的に更新されます。ほとんどの PHP アプリケーションで、MongoDB にアクセスするにはライブラリを依存関係として追加する必要があります。

拡張機能は PECL を使用して配布され、PHP をシステム ライブラリに接続します。拡張機能の公開 API は、次の機能を提供します。

• 接続マネジメント

• BSON のエンコードとデコード

• オブジェクト ドキュメントの直列化

• コマンド実行

• カーソル マネジメント

システム ライブラリの詳細については、C ドライバーのドキュメントを参照してください。

互換性のある MongoDB 配置への接続

PHP ドライバーを使用して、次の環境でホストされている配置に接続できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる、MongoDB の自己管理型バージョン

インストール

システムに最新バージョンのPHPがインストールされていることを確認してください。ダウンロードおよびインストールの手順については、PHPマニュアルを参照してください。

MongoDB PHPライブラリをインストールする前に、 PHP MongoDB拡張機能をインストールしてください。以下のようにコマンドラインで PECL を使用して拡張機能をインストールできます。

sudo pecl install mongodb

インストールが完了したら、php.iniファイルに次の行を追加します。

extension=mongodb.so

次に、 Composer を使用してPHPライブラリをインストールします。プロジェクトディレクトリから次のコマンドを実行します。

composer require mongodb/mongodb

インストールが完了したら、次の例に示すように、アプリケーションに Composer のオートローダーが含まれていることを確認します。

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

PHPライブラリのドキュメントには、 MongoDBデータの操作方法を示す参照資料とチュートリアルが含まれています。

互換性

32 ビットプラットフォームでは 64 ビット整数を表現する際に問題が発生する可能性があるため、64 ビット環境を使用することをお勧めします。332 ビット プラットフォームを使う場合は、データベースから読み込んだ 64 ビットの整数はいずれも、PHP の整数型ではなく、MongoDB\BSON\Int 64 インスタンスとして返されることに注意してください。