mongorecord MongoDb Active Record

  1. Documentation
  2. Change Log

This extension is a basic active record for MongoDb. I've used it in my project at This I have not fully tested it yet but so far it's work like I expected. I share it to you all so you can use it as reference or fix it if it has bugs.


  • Tested with Yii 1.1.2
  • Extract the release file under protected/components
  • Insert the code below in your config file inside components sections

See the following code example, this is an ActiveRecord example for Venue Collection:

 * Venue model used for interacting with venue collections in mongodb
 * @author yohan

class Venue extends MongoRecord
 * Default document to store inside a record
    protected $_document=array(
 * Return collection or table name 
    protected function  getCollectionName()
        return 'venue';
    public static function model($className=__CLASS__)
      return parent::model($className);
    public function rules()
        return array();

    public function attributeNames()
        return array();


This component was extended from CModel component, just like CActiveRecord component. And it's borrow many method from CActiveRecord. So basically you can use it just like you use CActiveRecord.

the $this->_document property is a default document that will store in MongoDb document. It just like table structure in conventional DB. Because it's like CActiveRecord, you can access and modify the your $_document record just like using class property. For example to insert new record;

$venue=new Venue;
$venue->save(FALSE); //disable validation

You can post your question on

To find records, you can use this both method that similar with CActiveRecord methods

$query=array('_id=>new MongoId('4c8377a88ead0ec468000000'));

this method will return MongoRecord instance


This method will return an array that contains MongoRecord instance

The $query is the same query that used in MongoRecord criteria query in PHP MongoDb query function. You can read how to write the criteria query on


I haven't implement ensure index function because I still confuse where is the best way to ensure the index of document. I though if I do it every time we call find() and findAll() method it will decrease it's performance. May be we need to call it manually to set the index in collection.

PLEASE USE latest source from GitHub at

Change Log

September 23, 2010
  • V 0.1.0 Initial release.
  • V 0.1.1 Fix bug on update document return duplicate index error.
7 0
1 045 downloads
Yii Version: 1.1
License: BSD-2-Clause
Category: Database
Tags: model, mongodb
Developed by: tyohan
Created on: Sep 23, 2010
Last updated: 13 years ago


show all

Related Extensions