| layout | title |
|---|---|
doc |
MongoDb - Codeception - Documentation |
If you use Codeception installed using composer, install this module with the following command:
{% highlight yaml %} composer require --dev codeception/module-mongodb
{% endhighlight %}
Alternatively, you can enable MongoDb module in suite configuration file and run
{% highlight yaml %} codecept init upgrade4
{% endhighlight %}
This module was bundled with Codeception 2 and 3, but since version 4 it is necessary to install it separately.
Some modules are bundled with PHAR files.
Warning. Using PHAR file and composer in the same project can cause unexpected errors.
Works with MongoDb database.
The most important function of this module is cleaning database before each test. To have your database properly cleaned you should configure it to access the database.
In order to have your database populated with data you need a valid js file with data (of the same style which can be fed up to mongo binary) File can be generated by RockMongo export command You can also use directory, generated by {% highlight yaml %} mongodump {% endhighlight %} tool or it's {% highlight yaml %} .tar.gz {% endhighlight %} archive (not available for Windows systems), generated by {% highlight yaml %} tar -czf <archive_file_name>.tar.gz <path_to dump directory> {% endhighlight %}. Just put it in {% highlight yaml %} tests/_data {% endhighlight %} dir (by default) and specify path to it in config. Next time after database is cleared all your data will be restored from dump. The DB preparation should as following:
- clean database
- system collection system.users should contain the user which will be authenticated while script performs DB operations
Connection is done by MongoDb driver, which is stored in Codeception\Lib\Driver namespace. Check out the driver if you get problems loading dumps and cleaning databases.
HINT: This module can be used with Mongofill library which is Mongo client written in PHP without extension.
- Maintainer: judgedim, davert
- Stability: beta
- Contact: davert@codeception.com
Please review the code of non-stable modules and provide patches if you have issues.
- dsn required - MongoDb DSN with the db name specified at the end of the host after slash
- user required - user to access database
- password required - password
- dump_type required - type of dump. One of 'js' (MongoDb::DUMP_TYPE_JS), 'mongodump' (MongoDb::DUMP_TYPE_MONGODUMP) or 'mongodump-tar-gz' (MongoDb::DUMP_TYPE_MONGODUMP_TAR_GZ). default: MongoDb::DUMP_TYPE_JS).
- dump - path to database dump
- populate: true - should the dump be loaded before test suite is started.
- cleanup: true - should the dump be reloaded after each test. Boolean or 'dirty'. If cleanup is set to 'dirty', the dump is only reloaded if any data has been written to the db during a test. This is checked using the dbHash command.
Checks if collection doesn't contain an item.
{% highlight php %}
dontSeeInCollection('users', array('name' => 'miles')); {% endhighlight %} * `param` $collection * `param array` $criteria #### grabCollectionCount Grabs the documents count from a collection {% highlight php %} grabCollectionCount('users'); // or $count = $I->grabCollectionCount('users', array('isAdmin' => true)); {% endhighlight %} * `param` $collection * `param array` $criteria * `return` integer #### grabFromCollection Grabs a data from collection {% highlight php %} grabFromCollection('users', array('name' => 'miles')); {% endhighlight %} * `param` $collection * `param array` $criteria * `return` array #### haveInCollection Inserts data into collection {% highlight php %} haveInCollection('users', array('name' => 'John', 'email' => 'john@coltrane.com')); $user_id = $I->haveInCollection('users', array('email' => 'john@coltrane.com')); {% endhighlight %} * `param` $collection * `param array` $data #### seeElementIsArray Asserts that an element in a collection exists and is an Array {% highlight php %} seeElementIsArray('users', array('name' => 'John Doe') , 'data.skills'); {% endhighlight %} * `param String` $collection * `param Array` $criteria * `param String` $elementToCheck #### seeElementIsObject Asserts that an element in a collection exists and is an Object {% highlight php %} seeElementIsObject('users', array('name' => 'John Doe') , 'data'); {% endhighlight %} * `param String` $collection * `param Array` $criteria * `param String` $elementToCheck #### seeInCollection Checks if collection contains an item. {% highlight php %} seeInCollection('users', array('name' => 'miles')); {% endhighlight %} * `param` $collection * `param array` $criteria #### seeNumElementsInCollection Count number of records in a collection {% highlight php %} seeNumElementsInCollection('users', 2); $I->seeNumElementsInCollection('users', 1, array('name' => 'miles')); {% endhighlight %} * `param` $collection * `param integer` $expected * `param array` $criteria #### useDatabase Specify the database to use {% highlight php %} useDatabase('db_1'); {% endhighlight %} * `param` $dbName