fahmiardi/mongoqb

Mongo Query Builder

1.3.3 2015-02-03 06:53 UTC

Requires

• php: >=5.3.0

Requires (Dev)

• phpunit/phpunit: *

MIT

• Fahmi Ardi
• Alex Bilbie

• database
• mongodb
• db
• mongo

README

Install via Packagist and Composer

Add the following into your composer.json file:

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

Then run

composer install

Install via Git

git clone git://[e-mail]:alexbilbie/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/alexbilbie/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 =]