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 インスタンスとして返されることに注意してください。