README

Provider for using Mongator with Laravel 4 framework

Requirements

PHP 5.3.x
Laravel 4
mongator/mongator

Installation

Add mongator/laravel to your composer requirements, you can see the package information on Packagist.:

{
    "require": {
        "mongator/laravel": "dev-master"
    }
}

Now, run composer update

Once the package is installed, open your app/config/app.php configuration file and locate the providers key. Add the following line to the end:

    ...
    'Mongator\Laravel\MongatorServiceProvider',
    ...

Next, locate the aliases key and add the following lines:

    ...
    'Mondator'        => 'Mongator\Laravel\Facades\Mondator',
    'Mongator'        => 'Mongator\Laravel\Facades\Mongator',
    ...

Now just create a YAML config classes dir at your app folder:

mkdir app/schema/

Parameters

connection_dsn (default 'mongodb://localhost:27017'): database connection string
connection_database: the database name
connection_name (default 'default'): the name of the connection
models_output (default 'app/models/'): output path of the classes
models_input (default 'app/schema/'): A valid dir with YAML definitions of the config classes
metadata_class: The metadata factory class name
logger (default false): enable the query logger
extensions (default Array()): array of extension instances

Usage

Route::get('/view', function() { 
    $articleRepository = Mongator::getRepository('Article');
    $article = $articleRepository->findOneById($id);

    return View::make($article);
});

Route::get('/create', function() { 
    $article = Mongator::create('Article');
    $article->setAuthor('John Doe');
    $article->setTitle('Lorem ipsum dolor sit amet, consectetur adipisicing elit.')
    $article->save();
});

Remember, before using the models you must generate them. (You can use the command provided with this package.)

Commands

With this package you can find three useful commands, thought php artisan:

mongator:generate: Processes config classes and generates the files of the classes.
mongator:_indexes: Ensures the indexes of all repositories
mongator:fix: Fixes all the missing references.

Tests

Tests are in the tests folder. To run them, you need PHPUnit. Example:

$ phpunit --configuration phpunit.xml.dist

License

MIT, see LICENSE

mongator / laravel

Maintainers

Details