aodto/mongoqb

Mongo Query Builder

1.3.1 2015-05-25 08:10 UTC

Requires

• php: >=5.3.0

Requires (Dev)

• phpunit/phpunit: *

MIT

• Alex Bilbie

• database
• mongodb
• db
• mongo

README

Install via Packagist and Composer

Add the following into your composer.json file:

{
	"require": {
		"aodto/mongoqb": "*"
	}
}

Then run

composer install

Install via Git

git clone git://[e-mail]:aodto/MongoQB

Download a zip/tarball

Download the latest version:

• zip
• tar

(Note the zip/tarball won't include any unit tests or composer files)

Unit tests

Master branch

Develop branch

The library currently has 100% unit test coverage. To run the unit test suite make sure you have MongoDB installed locally and running with no authentication and on the default port - 27017.

Then run:

composer update --dev
cd vendor/aodto/mongoqb
phpunit -c tests/phpunit.xml

Example usage

Connect to the database

$qb = \MongoQB\Builder(array(
	'dsn'	=>	'mongodb://user:pass@localhost:27017/databaseName'
);

Insert a document

$qb->insert('collectionName', [
	'name'	=>	'Alex',
	'age'	=>	22,
	'likes'	=>	['whisky', 'gin']
]);

Update a single document

$qb
	->where(['name' => 'Alex'])
	->set([
		'country' => 'UK',
		'job' => 'Developer'
	])
	->push('likes', ['PHP', 'coffee'])
	->update('collectionName');

Delete a single document

$qb
	->where(['name' => 'Alex'])
	->delete('collectionName');

Search for matching documents

$results = $qb
	->whereGt('age', 21)
	->whereIn('likes', ['whisky'])
	->where('country', 'UK')
	->get('collectionName');

If you find any bugs please file a report in the Issue tracker

If you find this software useful please consider donating, thank you =]