MongoDB

pecl install mongodb

# 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

composer require mongodb/laravel-mongodb

MONGODB_URI="mongodb://localhost:27017"
MONGODB_DATABASE="laravel_app"

MONGODB_URI="mongodb+srv://<username>:<password>@<cluster>.mongodb.net/<dbname>?retryWrites=true&w=majority"
MONGODB_DATABASE="laravel_app"

'connections' => [

    // ... bestehende Verbindungen ...

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

],

<?php

namespace App\Models;

use MongoDB\Laravel\Eloquent\Model;

class Article extends Model
{
    protected $connection = 'mongodb';
    protected $collection = 'articles'; // Collection-Name (wenn weggelassen, aus dem Klassennamen abgeleitet)

    protected $fillable = [
        'title',
        'body',
        'tags',
        'published_at',
    ];
}

use App\Models\Article;

// Anlegen
$article = Article::create([
    'title' => 'Einführung in MongoDB',
    'body' => 'MongoDB ist eine dokumentenorientierte Datenbank.',
    'tags' => ['nosql', 'mongodb', 'laravel'],
    'published_at' => now(),
]);

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

// Aktualisieren
$article->update(['title' => 'Einführung in MongoDB (überarbeitet)']);

// Löschen
$article->delete();

// Wert an ein Array-Feld anhängen
$article->push('tags', 'database');

// Wert aus einem Array-Feld entfernen
$article->pull('tags', 'nosql');

// Abfrage auf einem eingebetteten Dokument
$articles = Article::where('meta.author', 'Taylor')->get();

use Illuminate\Support\Facades\DB;

// Einfache Abfrage
$articles = DB::connection('mongodb')
    ->collection('articles')
    ->where('tags', 'laravel')
    ->orderBy('published_at', 'desc')
    ->limit(10)
    ->get();

// Aggregation-Pipeline
$stats = DB::connection('mongodb')
    ->collection('orders')
    ->raw(function ($collection) {
        return $collection->aggregate([
            ['$group' => ['_id' => '$status', 'total' => ['$sum' => '$amount']]],
            ['$sort' => ['total' => -1]],
        ]);
    });

'stores' => [

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

],

CACHE_STORE=mongodb

'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,
    ],

],

QUEUE_CONNECTION=mongodb

composer require league/flysystem-gridfs

'disks' => [

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

],

use Illuminate\Support\Facades\Storage;

// Datei hochladen
Storage::disk('gridfs')->put('file.pdf', $contents);

// Datei laden
$contents = Storage::disk('gridfs')->get('file.pdf');

use App\Models\Article;

// Embedding aus einem Query-String erzeugen (z. B. per OpenAI API)
$queryVector = getEmbedding('Was ist MongoDB'); // float[]-Array

$results = Article::query()->vectorSearch(
    index: 'vector_index',   // Name des Atlas-Vector-Search-Index
    path: 'embedding',       // Feld, in dem der Vektor gespeichert ist
    queryVector: $queryVector,
    limit: 10,               // Anzahl zurückgegebener Dokumente
    numCandidates: 100,      // Anzahl der Kandidaten (für ANN-Suche)
);

// Jedes Dokument erhält einen vectorSearchScore
foreach ($results as $result) {
    echo $result->title . ': ' . $result->vectorSearchScore;
}

SCOUT_DRIVER=mongodb

use Laravel\Scout\Searchable;
use MongoDB\Laravel\Eloquent\Model;

class Article extends Model
{
    use Searchable;

    // Legt die Felder fest, die in den Suchindex aufgenommen werden
    public function toSearchableArray(): array
    {
        return [
            'title' => $this->title,
            'body'  => $this->body,
            'tags'  => $this->tags,
        ];
    }
}

php artisan scout:index articles
php artisan scout:import "App\Models\Article"

// Volltextsuche
$results = Article::search('MongoDB Laravel')->get();

// Suche mit Filter
$results = Article::search('Query Builder')
    ->where('status', 'published')
    ->paginate(15);

// Reguläres Eloquent-Modell mit MySQL
class User extends \Illuminate\Database\Eloquent\Model
{
    protected $connection = 'mysql';
}

// Modell mit MongoDB
class Article extends \MongoDB\Laravel\Eloquent\Model
{
    protected $connection = 'mongodb';
}