MongoDB PHP ライブラリのインストール手順と使用例

Composer と MongoDB PHP ライブラリのインストール手順と使用例をまとめました。以下の内容をまとめています。

• Composer のインストール
• MongoDB PHP Extension（mongodb.so）のインストール
• MongoDB PHP Library（mongodb/mongodb）のインストール
• MongoDB を PHP から利用する簡単な使用例

1. Composer のインストール

1-1. インストーラのダウンロード

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

1-2. インストール実行

php composer-setup.php

1-3. composer.phar を /usr/local/bin に移動（任意）

sudo mv composer.phar /usr/local/bin/composer

これで composer コマンドが利用可能になります。

2. MongoDB PHP Extension（mongodb.so）のインストール

MongoDB を PHP から扱うには、まず MongoDB PHP Extension をインストールする必要があります。

2-1. PECL で拡張モジュールをインストール

sudo pecl install mongodb

2-2. php.ini に拡張を登録

echo "extension=mongodb.so" | sudo tee /etc/php/*/mods-available/mongodb.ini
sudo phpenmod mongodb

これで PHP が MongoDB 拡張を読み込むようになります。

3. MongoDB PHP Library（mongodb/mongodb）のインストール

MongoDB の公式 PHP ライブラリは Composer でインストールします。

3-1. プロジェクトディレクトリ作成

mkdir mongo-demo
cd mongo-demo

3-2. ライブラリのインストール

composer require mongodb/mongodb

これで vendor/autoload.php を読み込むだけで MongoDB を扱えるようになります。

4. MongoDB PHP ライブラリの簡単な使用例

以下は、MongoDB に接続し、データを挿入・取得する最小構成の例です。

4-1. ドキュメントを挿入する例

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

use MongoDB\Client;

// MongoDB に接続
$client = new Client('mongodb://localhost:27017');

// データベースとコレクションを選択
$collection = $client->demo->users;

// 挿入するデータ
$document = [
    'name' => 'Taro',
    'age'  => 30,
    'created_at' => new MongoDB\BSON\UTCDateTime()
];

// 挿入
$result = $collection->insertOne($document);

echo "Inserted ID: " . $result->getInsertedId() . "\n";

4-2. ドキュメントを取得する例

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

use MongoDB\Client;

$client = new Client('mongodb://localhost:27017');
$collection = $client->demo->users;

// 1件取得
$user = $collection->findOne(['name' => 'Taro']);

if ($user) {
    echo "Name: " . $user['name'] . "\n";
    echo "Age: " . $user['age'] . "\n";
}