Install MongoDB on Laravel Project — Jenssegers/MongoDB

Today I will show you how to using MongoDB database instead of using mySQL. By default since this story created, we need to manually installing MongoDB driver for laravel, and I will use jenssegers repository and install it by my own way. I’m using laravel version 5.6.* here by the way.

Step 1: Installing the repo to our project

Go to your project directory, in my case it is:

cd /home/fiko/www/project-1

Next, we need to install the jenssegers/mongodb using composer:

composer require jenssegers/mongodb 

composer require jenssegers/mongodb

Step 2: Add the service provider

Edit your config/app.php, and add this to your service providers:

Jenssegers\Mongodb\MongodbServiceProvider::class,

Jenssegers\Mongodb\MongodbServiceProvider::class

Step 3: Setting Up Database configuration

Next, we need to set the database configuration in config/database.php. And putting this code:

'default' => env('DB_CONNECTION', 'mongodb'),

‘default’ => env(‘DB_CONNECTION’, ‘mongodb’),

And these codes as well: (there are 2 options for the database configuration)

'mongodb' => [
    'driver'   => 'mongodb',
    'host'     => env('DB_HOST', 'localhost'),
    'port'     => env('DB_PORT', 27017),
    'database' => env('DB_DATABASE'),
    'username' => env('DB_USERNAME'),
    'password' => env('DB_PASSWORD'),
    'options'  => [
        'database' => 'admin' // sets the authentication database required by mongo 3
    ]
],

configuration, alternative 1

or this one, configuration, alternative 2:

'mongodb' => [
    'driver'   => 'mongodb',
    'dsn' => env('DB_DSN'),
    'database' => env('DB_DATABASE'),
],

configuration, alternative 2

for the second one, you can learn the DSN/URI here: https://docs.mongodb.com/manual/reference/connection-string/

Step 4: Config the .env File

Open up .env file. For alternative 1 on Step 3, use this config:

DB_CONNECTION=mongodb
DB_HOST=127.0.0.1
DB_PORT=27017
DB_DATABASE=database
DB_USERNAME=username
DB_PASSWORD=password

alternative 1

For alternative 2, use this config:

DB_CONNECTION=mongodb
DB_DSN=mongodb://username:password@127.0.0.1:27017/database_name
DB_DATABASE=database_name

alternative 2

Step 5: Replacing the eloquent

Instead of using Illuminate eloquent by laravel, change and use the eloquent from jenssegers/mongodb:

<?php
namespace App;
use Illuminate\Database\Eloquent\Model;
use Jenssegers\Mongodb\Eloquent\Model as Eloquent;
class ExampleController extends Eloquent {
    //
}

— Completed —

Your laravel project using MongoDB by Jens Segers is ready to develope.