Skip to main content

​
Overview

BaseModelMongo is the MongoDB equivalent of BaseModel, providing the same REST API capabilities for MongoDB collections using the Laravel MongoDB package. 
namespace Ronu\RestGenericClass\Core\Models;

use MongoDB\Laravel\Eloquent\Model;

class BaseModelMongo extends Model
This class requires the mongodb/laravel-mongodb package to be installed separately. It is not included by default.

​
Installation

To use MongoDB models, install the Laravel MongoDB package: 
composer require mongodb/laravel-mongodb
Configure your MongoDB connection in config/database.php: 
'mongodb' => [
    'driver' => 'mongodb',
    'host' => env('DB_MONGO_HOST', '127.0.0.1'),
    'port' => env('DB_MONGO_PORT', 27017),
    'database' => env('DB_MONGO_DATABASE', 'homestead'),
    'username' => env('DB_MONGO_USERNAME', 'homestead'),
    'password' => env('DB_MONGO_PASSWORD', 'secret'),
    'options' => [
        'database' => env('DB_MONGO_AUTH_DATABASE', 'admin'),
    ],
],

​
Basic Usage

Create a MongoDB model by extending BaseModelMongo: 
<?php

namespace App\Models;

use Ronu\RestGenericClass\Core\Models\BaseModelMongo;

class Product extends BaseModelMongo
{
    protected $connection = 'mongodb';
    protected $collection = 'products';
    
    protected $fillable = ['name', 'price', 'stock', 'category_id'];
    
    const MODEL = 'product';
    const RELATIONS = ['category', 'reviews'];
    
    public function category()
    {
        return $this->belongsTo(Category::class);
    }
    
    public function reviews()
    {
        return $this->hasMany(Review::class);
    }
}

​
Constants

BaseModelMongo supports the same constants as BaseModel:
​
MODEL
string
required
The model identifier used in API responses and logging
​
columns
array
default:"[]"
Default columns to select when querying the model
​
RELATIONS
array
default:"[]"
Whitelisted relations that can be eager loaded via the API
​
HIERARCHY_FIELD_ID
string|null
default:"null"
The field name for self-referencing hierarchy (e.g., ‘parent_id’)

​
MongoDB-Specific Relations

BaseModelMongo provides helper methods for MongoDB relations:

​
belongsToMongo

Define a MongoDB BelongsTo relationship: 
public function category()
{
    return $this->belongsToMongo(Category::class, 'category_id');
}

​
hasManyMongo

Define a MongoDB HasMany relationship: 
public function reviews()
{
    return $this->hasManyMongo(Review::class, 'product_id');
}

​
hasOneMongo

Define a MongoDB HasOne relationship: 
public function detail()
{
    return $this->hasOneMongo(ProductDetail::class, 'product_id');
}

​
Features

All BaseModel features work with BaseModelMongo:
  • Dynamic filtering with operators
  • Relation loading with field selection
  • Hierarchical data support
  • Role-based field restrictions
  • Validation and form requests
  • Export to Excel/PDF

​
Differences from BaseModel

  1. Connection: Uses MongoDB driver instead of SQL
  2. Collection: Uses $collection property instead of $table
  3. Relations: MongoDB-specific relation methods
  4. Schema: Schemaless - no migrations required
  5. Query Builder: MongoDB query builder syntax

​
Example Service

Use BaseModelMongo with BaseService just like regular models: 
<?php

namespace App\Services;

use App\Models\Product;
use Ronu\RestGenericClass\Core\Services\BaseService;

class ProductService extends BaseService
{
    public function __construct()
    {
        parent::__construct(Product::class);
    }
}

​
Example Controller

Controllers work identically with MongoDB models: 
<?php

namespace App\Http\Controllers\Api;

use App\Models\Product;
use App\Services\ProductService;
use Ronu\RestGenericClass\Core\Controllers\RestController;

class ProductController extends RestController
{
    protected $modelClass = Product::class;
    
    public function __construct(ProductService $service)
    {
        $this->service = $service;
    }
}

​
Limitations

Some SQL-specific features may not work with MongoDB:
  • Complex joins across different databases
  • SQL-specific operators (some may need MongoDB equivalents)
  • Database transactions work differently in MongoDB

​
Next Steps

BaseModel

Learn about the SQL version

BaseService

Using services with MongoDB models

Filtering

Dynamic filtering with MongoDB

Relations

Working with MongoDB relations

Build docs developers (and LLMs) love

Get started for freeTalk to us