Martin Helmich
This library is MIT-licenced.
This class contains implementations of the MongoDB\Collection and MongoDB\Database classes (not to be confused with the Mongo\Collection class from the deprecated mongo extension) that can store, modify and filter documents in memory, together with a set of (optional) PHPUnit assertions.
I wrote this library because I wanted to unit-test a library that used MongoDB
collections intensively and felt that mocking the MongoDB\Collection
class
using PHPUnit's built-in mock builders was too restrictive.
Note: Currently, this implementation contains only a subset of the actual MongoDB collection API. I've only implemented the parts of the API that I needed for my use case. If you need additional functionality, feel free to open an issue, or (better yet) a pull request.
$ composer require --dev helmich/mongomock
There are several release branches of this library, each of these being compatible with different releases of PHPUnit and PHP. The following table should give an easy overview:
"Mongomock" version | PHPUnit 4 | PHPUnit 5 | PHPUnit 6 | PHPUnit 7 | PHPUnit 8 |
---|---|---|---|---|---|
v1 (branch v1 ), unsupported |
๐ซ | โ | ๐ซ | ๐ซ | ๐ซ |
v2 (branch master ) |
๐ซ | ๐ซ | โ | โ | โ |
When you are using composer require
and have already declared a dependency to phpunit/phpunit
in your composer.json
file, Composer should pick latest compatible version automatically.
You can use this library exactly as you'd use the MongoDB\Collection
or MongoDB\Database
classes
(in theory, at least -- remember, this package is not API-complete):
use Helmich\MongoMock\MockCollection;
$collection = new MockCollection();
$collection->createIndex(['foo' => 1]);
$documentId = $collection->insertOne(['foo' => 'bar'])->insertedId();
$collection->updateOne(['_id' => $documentId], ['$set' => ['foo' => 'baz']]);
In some aspects, the MongoDB\Collection
's API was extended to allow for better
testability:
-
Filter operands may contain callback functions that are applied to document properties:
$r = $collection->find([ 'someProperty' => function($p) { return $p == 'bar'; } ]);
-
Filter operands may contain PHPUnit constraints (meaning instances of the
PHPUnit_Framework_Constraint
class). You can easily build these using the factory functions in thePHPUnit_Framework_Assert
class.$r = $collection->find([ 'someProperty' => \PHPUnit_Framework_Assert::isInstanceOf(\MongoDB\BSON\Binary::class) ]);
To run the tests (anywhere with a running Docker installation):
$ docker-compose run phpunit