flatline/mongol

MongoDB library and Auth driver for Laravel 4

laravel-mongol

MongoDB library and Auth driver for Laravel 4., _(*1)

It extends PHP's MongoDB Native Driver., _(*2)

Installation

Require flatline/mongol in your project's composer.json:, _(*3)

{
    "require": {
        "flatline/mongol": "0.1.*"
    }
}

Update or install your packages with composer update or composer install respectively., _(*4)

Now you need to register MongolServiceProvider with Laravel.
Open up app/config/app.php and add the following to the providers key:, _(*5)

'Flatline\Mongol\MongolServiceProvider'

You can also register the facade in the class aliases, look for the aliases key and add the following:, _(*6)

'Mongol' => 'Flatline\Mongol\Mongol'

This way you can use Mongol::connection() instead of Flatline\Mongol\Mongol::connection()., _(*7)

Configuration

In order to use your own database credentials you can extend the package configuration by creating app/config/packages/flatline/mongol/config.php., _(*8)

You can do this by running the following Artisan command., _(*9)

$ php artisan config:publish flatline/mongol

Here's an example configuration using mongohq, _(*10)

'default' => array(
    'host'     => 'alex.mongohq.com',
    'port'     => 10002,
    'username' => 'your_username',
    'password' => 'your_db_password',
    'database' => 'your_db_name',
),

You can also connect as admin, _(*11)

'other_credentials' => array(
    'host'     => 'localhost',
    'username' => 'your_admin_username',
    'password' => 'your_admin_db_password',
    'database' => 'your_db_name',
    'admin'    => true,
),

You can create as many database credential groups as you need., _(*12)

Auth Driver configuration

To use Mongol with the Auth library, just set 'mongol' as the driver in app/config/auth.php:, _(*13)

'driver' => 'mongol'

Usage

You use it the same way you would use the native driver, but first you need to get the connection and database., _(*14)

To get your default connection use:, _(*15)

Mongol::connection();

To get other connection:, _(*16)

Mongol::connection('group');

To get the database just use:, _(*17)

Mongol::connection()->getDB();

And to get other db using the same credentials (you must be authenticated as admin), you can use:, _(*18)

Mongol::connection()->getDB('other_db_name')