メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://kawax.biz/llms.txt

Use this file to discover all available pages before exploring further.

​
はじめに

MongoDB は最も人気のある NoSQL ドキュメント指向データベースの一つです。高い書き込み性能（分析や IoT に最適）、高可用性（レプリカセットによる自動フェイルオーバー）、水平スケーリング（シャーディング）、強力なクエリ言語（集計・全文検索・地理空間クエリ）が特徴です。 SQL データベースの行・列形式とは異なり、MongoDB の各レコードは BSON（バイナリ JSON）形式のドキュメントです。アプリケーションはこのデータを JSON 形式で取得できます。
Laravel で MongoDB を使う場合は、MongoDB 公式がメンテナンスする mongodb/laravel-mongodb パッケージの使用を推奨します。このパッケージは Eloquent や Laravel の各種機能とのリッチな統合を提供します。

​
インストール

​
MongoDB PHP ドライバ

MongoDB に接続するには mongodb PHP 拡張が必要です。Laravel Herd や php.new を使っている場合はすでにインストール済みです。手動でインストールするには PECL を使います。 
pecl install mongodb
インストール詳細は MongoDB PHP 拡張インストールガイド を参照してください。
mongodb PHP 拡張が CLI と Web サーバーの両方で有効になっていることを確認してください。設定が異なる場合があります。

​
MongoDB サーバーの起動

MongoDB Community Server はローカル開発用に使用できます。Windows、macOS、Linux、Docker でのインストール方法は 公式インストールガイド を参照してください。 Docker を使う場合: 
# docker-compose.yml
services:
  mongodb:
    image: mongo:8
    ports:
      - "27017:27017"
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: password
      MONGO_INITDB_DATABASE: laravel_app
    volumes:
      - mongodb_data:/data/db

volumes:
  mongodb_data:

docker compose up -d
クラウドでのホスティングには MongoDB Atlas が利用できます。Atlas クラスターにローカルからアクセスするには、プロジェクトの IP アクセスリストに自分の IP アドレスを追加する必要があります。

​
laravel-mongodb パッケージのインストール

Composer で mongodb/laravel-mongodb パッケージをインストールします。 
composer require mongodb/laravel-mongodb

​
設定

​
環境変数

.env ファイルに MongoDB の接続情報を追加します。 
MONGODB_URI="mongodb://localhost:27017"
MONGODB_DATABASE="laravel_app"
MongoDB Atlas を使う場合は接続文字列を Atlas のものに変更します。 
MONGODB_URI="mongodb+srv://<username>:<password>@<cluster>.mongodb.net/<dbname>?retryWrites=true&w=majority"
MONGODB_DATABASE="laravel_app"

​
config/database.php

config/database.php の connections 配列に mongodb 接続を追加します。 
'connections' => [

    // ... 既存の接続設定 ...

    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => env('MONGODB_URI', 'mongodb://localhost:27017'),
        'database' => env('MONGODB_DATABASE', 'laravel_app'),
    ],

],
MySQL などのリレーショナル DB と MongoDB を同時に使う場合は、default はそのままにして mongodb 接続を追加するだけで OK です。モデルごとに接続を切り替えられます。

​
主要機能

​
Eloquent モデル

MongoDB\Laravel\Eloquent\Model を継承することで、通常の Eloquent モデルとほぼ同じ感覚で MongoDB を操作できます。 
<?php

namespace App\Models;

use MongoDB\Laravel\Eloquent\Model;

class Article extends Model
{
    protected $connection = 'mongodb';
    protected $collection = 'articles'; // コレクション名（省略時はクラス名から自動生成）

    protected $fillable = [
        'title',
        'body',
        'tags',
        'published_at',
    ];
}
MongoDB はスキーマレスなので、マイグレーションは不要です。ドキュメントを保存すると自動的にコレクションが作成されます。

​
基本的な CRUD 操作

通常の Eloquent と同じ API で操作できます。 
use App\Models\Article;

// 作成
$article = Article::create([
    'title' => 'MongoDB入門',
    'body' => 'MongoDBはドキュメント指向データベースです。',
    'tags' => ['nosql', 'mongodb', 'laravel'],
    'published_at' => now(),
]);

// 取得
$article = Article::find('64f1a2b3c4d5e6f7a8b9c0d1');
$articles = Article::where('tags', 'nosql')->get();

// 更新
$article->update(['title' => '改訂版 MongoDB入門']);

// 削除
$article->delete();

​
配列・埋め込みドキュメント

MongoDB の強みである配列や埋め込みドキュメントをそのまま扱えます。 
// 配列フィールドへの push
$article->push('tags', 'database');

// 配列フィールドからの pull
$article->pull('tags', 'nosql');

// 埋め込みドキュメントのクエリ
$articles = Article::where('meta.author', 'Taylor')->get();

​
クエリビルダー

MongoDB のクエリビルダーを使って複雑なクエリを記述できます。詳細は laravel-mongodb クエリビルダードキュメント を参照してください。 
use Illuminate\Support\Facades\DB;

// 基本的なクエリ
$articles = DB::connection('mongodb')
    ->collection('articles')
    ->where('tags', 'laravel')
    ->orderBy('published_at', 'desc')
    ->limit(10)
    ->get();

// 集計パイプライン
$stats = DB::connection('mongodb')
    ->collection('orders')
    ->raw(function ($collection) {
        return $collection->aggregate([
            ['$group' => ['_id' => '$status', 'total' => ['$sum' => '$amount']]],
            ['$sort' => ['total' => -1]],
        ]);
    });

​
キャッシュドライバ

MongoDB のキャッシュドライバは TTL インデックスを使って期限切れエントリを自動的に削除します。詳細は キャッシュドライバドキュメント を参照してください。 config/cache.php にストアを追加します。 
'stores' => [

    'mongodb' => [
        'driver' => 'mongodb',
        'connection' => 'mongodb',
        'collection' => 'cache',
    ],

],
.env でキャッシュドライバを MongoDB に変更します。 
CACHE_STORE=mongodb

​
キュードライバ

MongoDB をキュードライバとして使うことができます。詳細は キュードライバドキュメント を参照してください。 config/queue.php に接続を追加します。 
'connections' => [

    'mongodb' => [
        'driver' => 'mongodb',
        'connection' => 'mongodb',
        'collection' => 'jobs',
        'queue' => env('MONGODB_QUEUE', 'default'),
        'retry_after' => (int) env('MONGODB_QUEUE_RETRY_AFTER', 90),
        'after_commit' => false,
    ],

],
.env でキュー接続を MongoDB に変更します。 
QUEUE_CONNECTION=mongodb

​
GridFS によるファイル保存

MongoDB の GridFS を使ってファイルを保存できます。Flysystem 用 GridFS アダプター を利用します。詳細は GridFS ドキュメント を参照してください。 
composer require league/flysystem-gridfs
config/filesystems.php にディスクを追加します。 
'disks' => [

    'gridfs' => [
        'driver' => 'gridfs',
        'connection' => 'mongodb',
        'database' => env('MONGODB_DATABASE', 'laravel_app'),
    ],

],

use Illuminate\Support\Facades\Storage;

// ファイルのアップロード
Storage::disk('gridfs')->put('file.pdf', $contents);

// ファイルの取得
$contents = Storage::disk('gridfs')->get('file.pdf');

​
MySQL との併用

Laravel では MySQL と MongoDB を同時に使用できます。モデルごとに $connection プロパティで接続を指定します。 
// MySQL を使う通常の Eloquent モデル
class User extends \Illuminate\Database\Eloquent\Model
{
    protected $connection = 'mysql';
}

// MongoDB を使うモデル
class Article extends \MongoDB\Laravel\Eloquent\Model
{
    protected $connection = 'mongodb';
}
MySQL モデルと MongoDB モデルの間でリレーションを持たせる場合は、ハイブリッドリレーション を参照してください。

​
まとめ

  1. pecl install mongodb で PHP 拡張をインストール
  2. MongoDB サーバーを起動（ローカルまたは Docker、または Atlas）
  3. composer require mongodb/laravel-mongodb でパッケージをインストール
  4. .env に MONGODB_URI と MONGODB_DATABASE を設定
  5. config/database.php に mongodb 接続を追加
特性MongoDBMySQL
データモデルドキュメント（JSON/BSON）テーブル（行・列）
スキーマスキーマレス（柔軟）固定スキーマ
スケーリング水平スケーリングが容易垂直スケーリングが主流
トランザクションマルチドキュメント対応（v4+）完全な ACID 対応
適した用途ログ・分析・IoT・柔軟な構造のデータ構造化データ・複雑なリレーション
機能設定箇所
Eloquent モデルMongoDB\Laravel\Eloquent\Model を継承
クエリビルダーDB::connection('mongodb')->collection(...)
キャッシュconfig/cache.php + CACHE_STORE=mongodb
キューconfig/queue.php + QUEUE_CONNECTION=mongodb
ファイル保存config/filesystems.php + GridFS アダプター

​
次のステップ

laravel-mongodb 公式ドキュメント

Eloquent、クエリビルダー、リレーションなど全機能の詳細リファレンス

クイックスタート

MongoDB と Laravel の基本的な使い方を素早く学ぶ

データベース設定

Laravel のデータベース接続設定の基本

Eloquent入門

Eloquent ORM の基本的な使い方
Last modified on June 1, 2026