Wallogit.com
2017 © Pedro Peláez
A wrapper for PHP MongoDB drivers
A simple abstraction layer for PHP MongoDB Driver, (*1)
- Current Build: 0.0.1_nb
- Stability: Unstable
- Compatibility:
- MongoDB >= 1.5.x
- PHP >= 5.4.x, (*2)
MongoJacke is not one of those bloated ODMs you encounter everyday. It essentially gives developers an interface similar to native Mongo driver. In addition to that, MongoJacke allows developer to add custom methods, callbacks and validation rules., (*3)
Install composer in your project, (*4)
curl -s https://getcomposer.org/installer | php
Create a composer.json file in your project, (*5)
{
"require": {
"mongojacket/mongojacket": "dev-master"
}
}
Run composer install, (*6)
php composer.phar install
Add this line to your application, (*7)
require 'vendor/autoload.php';
Git clone mongojacket in your project, (*8)
git clone git://github.com/souravray/mongojacket.git
Include following line to your application, (*9)
// inclue MongoJacket file
include_once("Path To MongoJacket/index.php");
// register autoloader
spl_autoload_register('MongoJacket\MongoJacketAutoloader');
API is exactly same as PHP-Mongo driver., (*10)
Using native driver, (*11)
$m = new MongoClient("mongodb://user:pas@localhost:27017/test");
Using MongoJacket, (*12)
$jacket = new MongoJacket\Jacket('localhost:27017', 'test', 'user', 'pass');
Using native driver, (*13)
$db = $m->selectDB("rockband");
Using MongoJacket, (*14)
$db = $jacket->db('rockband');
Using native driver, (*15)
$collection = $db->selectCollection('bands');
Using MongoJacket, (*16)
$collection = $db->collection('bands');
You can call commands in chain, (*17)
$jacket->db('rockband')->collection('bands')->find();
Currently only following query methods of native PHP-Mongo drive are supported in MongoJacket., (*18)
find, findOne, insert, save, batchInsert, findAndModify, Update, (*19)
MongoJackect query methods return the same value as native APIs or an exception object in case of any exception., (*20)
As an additional parameter to any query method you can pass an anonymous function as callback. All the following syntax are correct. Callback method can return a value to the caller of the parent query., (*21)
// pass a callback method to find method
// without any criteria or field specified
$bands = $jacket->db('rockband')->collection('bands')->find(
function($results,$error){
// data transformation logic
return $results; //return to the calling parameter
}
);
// pass a callback method to find method
// with only criteria specified
$bands = $jacket->db('rockband')->collection('bands')->find(
array("year" => array('gr' => 1963)) ,
function($results,$error){
// data transformation logic
return $results; //return to the calling parameter
}
);
// pass a callback method to find method
// with only criteria and field specified
$bands = $jacket->db('rockband')->collection('bands')->find(
array("year" => array('gr' => 1963)) ,
array("name", "album", "awards", "members") ,
function($results,$error){
// data transformation logic
return $results; //return to the calling parameter
}
);
In the callback method you are allowed tho use $this.
It is allowed to call another query method and pass a callback function inside a callback function. Theoretically it can be looped till infinite time. All inner queries and callbacks will be executed in sequence., (*22)
// command/ callback sequencing
$bands = $jacket->db('rockband')->collection('bands')->find(
function($results,$error){
// check some condition
// add a new entry
$this->save( array(
"name"=>"Velvet Revolver",
"members"=> array("Scott Weiland",
"Slash",
"Dave Kushner",
"Matt Sorum",
"Duff McKagan"),
"year"=>1984) ,
function ($result, $error){
// some code here
} );
return $results; //return to the calling parameter
}
);
MongoJacket exceptions are objects \MongoJacket\Exception. Exceptions are not thrown in MongoJacket APIs. In case of an exception MongoJacket will return an \MongoJacket\Exception object instead of result when callback method is not available. You can validate the response like bellow., (*23)
// no callback is added
$isinseted = $jacket->db('rockband')->collection('bands')->save( array(
"name"=>"Velvet Revolver",
"members"=> array("Scott Weiland",
"Slash",
"Dave Kushner",
"Matt Sorum",
"Duff McKagan"),
"year"=>1984) );
if(is_a($isinseted, '\MongoJacket\Exception' ){
// some diagnostic action
}
when a callback function is added. Exception object is passed as the second parameter to the function. If no exception is there then null is passed in that place., (*24)
// a callback is added
$bands = $jacket->db('rockband')->collection('bands')->find(
function($results,$error){
if(is_null($error)
&& is_a($error, '\MongoJacket\Exception' ){
// some diagnostic action
}
}
);
A custom method can be binded to a collection like bellow., (*25)
$jacket->db('rockband')->collection('bands')->bind(
"McKaganBands",
function (){
return $this->find(array("member" => 'Duff McKagan'));
});
Calling custom method, (*26)
$jacket->db('rockband')->collection('bands')->McKaganBands();
The function cannot accept multiple parameters in the definition. Any parameter passed during custom method call can be accessed using func_get_args()., (*27)
MongoJacket support a mechanism for adding middleware. A simple middleware can be written like bellow., (*28)
class MyMiddleware extends \MongoJacket\Middleware{
// your middileware logic should be here
public function call(){
// here do some magic
$this->next->call();
}
}
Middleware can be bind to following Pre or Post events:
init, find, save, delete
At present only Collection implements middleware protocol, and the registry method is a private method. MongoJacket will add ability to register third-party middlewars in future., (*29)
MongoJacket validator is a Middleware. MongoJacket does not required any schema definition for mapping. It allows to add validation rules to Document elements for a collection. The validator method get called during Pre Save event. If a validation fails then an the query fails and exception object is returned., (*30)
// Validator-1
$jacket->db('rockband')->
collection('bands')->
validator('year',
function ($var) {
// no new band after 2010 is allowed
return ($var<2010);
}
);
// Validator-2
$jacket->db('rockband')->
collection('bands')->
validator('name',
function ($var) {
// Limp Bizkit is not allowed
return !($var=="Limp Bizkit");
}
);
// this will fail due to Validator 1
$jacket->db('rockband')
->collection('bands')->insert(array(
"name"=>"Modern Alarms",
"members"=> array( "Dominic Barber",
"David Fraser",
"Colm Feeley",
"Andy Gledhill"),
"year"=>2012)
);
// this will fail due to Validator 2
$jacket->db('rockband')
->collection('bands')->insert(array(
"name"=>"Limp Bizkit",
"members"=> array( "Fred Durst",
"Wes Borland",
"Sam Rivers",
"John Otto",
"DJ Lethal"),
"year"=>1994)
);
By default if another validator is added to same entity, then the first validation rule will be over ridden by the lastly added rule., (*31)
// Validator-1
$jacket->db('rockband')->
collection('bands')->
validator('year',
function ($var) {
// only bands formed before 2012 are allowed
return ($var<2012);
}
);
// Validator-2 overrides the rule
$jacket->db('rockband')->
collection('bands')->
validator('year',
function ($var) {
// only bands formed after 1994 is allowed
return ($var>1994);
}
);
// this will be success because the final rule: year > 1994
$jacket->db('rockband')
->collection('bands')->insert(array(
"name"=>"Modern Alarms",
"members"=> array( "Dominic Barber",
"David Fraser",
"Colm Feeley",
"Andy Gledhill"),
"year"=>2012)
);
// this will fail because the final rule: year > 1994
$jacket->db('rockband')
->collection('bands')->insert(array(
"name"=>"Limp Bizkit",
"members"=> array( "Fred Durst",
"Wes Borland",
"Sam Rivers",
"John Otto",
"DJ Lethal"),
"year"=>1994)
);
In the above example if the second validator Boolean false is passed as second parameter to the validator method, then both the validation rules will be chained., (*32)
// Validator-1
$jacket->db('rockband')->
collection('bands')->
validator('year',
function ($var) {
// only bands formed before 2012 are allowed
return ($var<2012);
}
);
// Validator-2 overrides the rule
$jacket->db('rockband')->
collection('bands')->
validator('year',
function ($var) {
// only bands formed after 1994 is allowed
return ($var>1994);
},
false
);
// this will fail because the final rule: 1994 < year < 2012
$jacket->db('rockband')
->collection('bands')->insert(array(
"name"=>"Modern Alarms",
"members"=> array( "Dominic Barber",
"David Fraser",
"Colm Feeley",
"Andy Gledhill"),
"year"=>2012)
);
// this will fail because the final rule: 1994 < year < 2012
$jacket->db('rockband')
->collection('bands')->insert(array(
"name"=>"Limp Bizkit",
"members"=> array( "Fred Durst",
"Wes Borland",
"Sam Rivers",
"John Otto",
"DJ Lethal"),
"year"=>1994)
);
A wrapper for PHP MongoDB drivers
The BSD 2-Clause License
mongodb mongo odm php 5.4