updated

Author: github-actions[bot]

changelog.markdown

@@ -9,6 +9,30 @@ title: Codeception Changelog
 
 
 
+### module-db 3.1.0: 3.1.0
+
+Released by [![](https://avatars.githubusercontent.com/u/395992?v=4&s=16) Naktibalda](https://github.com/Naktibalda) on 2022/12/03 10:23:12 / [Repository](https://github.com/Codeception/module-db)   / [Releases](https://github.com/Codeception/module-db/releases)
+
+
+
+* Implemented `grabEntryFromDatabase` and `grabEntriesFromDatabase` methods by **[JesusTheHun](https://github.com/JesusTheHun)** in https://github.com/Codeception/module-db/pull/43
+* Improved handling of auto_increment field in `haveInDatabase` tear down by **[JesusTheHun](https://github.com/JesusTheHun)** in https://github.com/Codeception/module-db/pull/44
+* Add docker elements to ease local testing by **[JesusTheHun](https://github.com/JesusTheHun)** in https://github.com/Codeception/module-db/pull/42
+
+
+
+### module-db 2.1.0: 2.1.0
+
+Released by [![](https://avatars.githubusercontent.com/u/395992?v=4&s=16) Naktibalda](https://github.com/Naktibalda) on 2022/12/03 10:22:30 / [Repository](https://github.com/Codeception/module-db)   / [Releases](https://github.com/Codeception/module-db/releases)
+
+
+
+* Implemented `grabEntryFromDatabase` and `grabEntriesFromDatabase` methods by **[JesusTheHun](https://github.com/JesusTheHun)** in https://github.com/Codeception/module-db/pull/43
+* Improved handling of auto_increment field in `haveInDatabase` tear down by **[JesusTheHun](https://github.com/JesusTheHun)** in https://github.com/Codeception/module-db/pull/44
+* Add docker elements to ease local testing by **[JesusTheHun](https://github.com/JesusTheHun)** in https://github.com/Codeception/module-db/pull/42
+
+
+
 ### Codeception 5.0.5: 5.0.5
 
 Released by [![](https://avatars.githubusercontent.com/u/395992?v=4&s=16) Naktibalda](https://github.com/Naktibalda) on 2022/11/20 11:33:41 / [Repository](https://github.com/Codeception/Codeception)   / [Releases](https://github.com/Codeception/Codeception/releases)

docs/modules/Db.md

@@ -35,7 +35,7 @@ Warning. Using PHAR file and composer in the same project can cause unexpected e
 Access a database.
 
 The most important function of this module is to clean a database before each test.
-This module also provides actions to perform checks in a database, e.g. [seeInDatabase()](http://codeception.com/docs/modules/Db#seeInDatabase)
+This module also provides actions to perform checks in a database, e.g. [seeInDatabase()](https://codeception.com/docs/modules/Db#seeInDatabase)
 
 In order to have your database populated with data you need a raw SQL dump.
 Simply put the dump in the `tests/_data` directory (by default) and specify the path in the config.
@@ -67,11 +67,11 @@ if you run into problems loading dumps and cleaning databases.
 * cleanup: false - whether the dump should be reloaded before each test
 * reconnect: false - whether the module should reconnect to the database before each test
 * waitlock: 0 - wait lock (in seconds) that the database session should use for DDL statements
-* ssl_key - path to the SSL key (MySQL specific, @see http://php.net/manual/de/ref.pdo-mysql.php#pdo.constants.mysql-attr-key)
-* ssl_cert - path to the SSL certificate (MySQL specific, @see http://php.net/manual/de/ref.pdo-mysql.php#pdo.constants.mysql-attr-ssl-cert)
-* ssl_ca - path to the SSL certificate authority (MySQL specific, @see http://php.net/manual/de/ref.pdo-mysql.php#pdo.constants.mysql-attr-ssl-ca)
-* ssl_verify_server_cert - disables certificate CN verification (MySQL specific, @see http://php.net/manual/de/ref.pdo-mysql.php)
-* ssl_cipher - list of one or more permissible ciphers to use for SSL encryption (MySQL specific, @see http://php.net/manual/de/ref.pdo-mysql.php#pdo.constants.mysql-attr-cipher)
+* ssl_key - path to the SSL key (MySQL specific, @see https://php.net/manual/de/ref.pdo-mysql.php#pdo.constants.mysql-attr-key)
+* ssl_cert - path to the SSL certificate (MySQL specific, @see https://php.net/manual/de/ref.pdo-mysql.php#pdo.constants.mysql-attr-ssl-cert)
+* ssl_ca - path to the SSL certificate authority (MySQL specific, @see https://php.net/manual/de/ref.pdo-mysql.php#pdo.constants.mysql-attr-ssl-ca)
+* ssl_verify_server_cert - disables certificate CN verification (MySQL specific, @see https://php.net/manual/de/ref.pdo-mysql.php)
+* ssl_cipher - list of one or more permissible ciphers to use for SSL encryption (MySQL specific, @see https://php.net/manual/de/ref.pdo-mysql.php#pdo.constants.mysql-attr-cipher)
 * databases - include more database configs and switch between them in tests.
 * initial_queries - list of queries to be executed right after connection to the database has been initiated, i.e. creating the database if it does not exist or preparing the database collation
 * skip_cleanup_if_failed - Do not perform the cleanup if the tests failed. If this is used, manual cleanup might be required when re-running
@@ -352,6 +352,67 @@ $mails = $I->grabColumnFromDatabase('users', 'email', array('name' => 'RebOOter'
 {% endhighlight %}
 
 
+#### grabEntriesFromDatabase
+
+* `param string` $table
+* `param array` $criteria
+* `throws PDOException|Exception`
+* `return array<array<string,` mixed>> Returns an array of all matched rows
+
+Fetches a set of entries from a database.
+
+Provide table name and criteria.
+
+{% highlight php %}
+
+<?php
+$mail = $I->grabEntriesFromDatabase('users', array('name' => 'Davert'));
+
+{% endhighlight %}
+Comparison expressions can be used as well:
+
+{% highlight php %}
+
+<?php
+$post = $I->grabEntriesFromDatabase('posts', ['num_comments >=' => 100]);
+$user = $I->grabEntriesFromDatabase('users', ['email like' => 'miles%']);
+
+{% endhighlight %}
+
+Supported operators: `<`, `>`, `>=`, `<=`, `!=`, `like`.
+
+
+#### grabEntryFromDatabase
+
+* `param string` $table
+* `param array` $criteria
+* `throws PDOException|Exception`
+* `return array` Returns a single entry value
+
+Fetches a whole entry from a database.
+
+Make the test fail if the entry is not found.
+Provide table name, desired column and criteria.
+
+{% highlight php %}
+
+<?php
+$mail = $I->grabEntryFromDatabase('users', array('name' => 'Davert'));
+
+{% endhighlight %}
+Comparison expressions can be used as well:
+
+{% highlight php %}
+
+<?php
+$post = $I->grabEntryFromDatabase('posts', ['num_comments >=' => 100]);
+$user = $I->grabEntryFromDatabase('users', ['email like' => 'miles%']);
+
+{% endhighlight %}
+
+Supported operators: `<`, `>`, `>=`, `<=`, `!=`, `like`.
+
+
 #### grabFromDatabase
 
 * `param string` $table
@@ -374,8 +435,8 @@ Comparison expressions can be used as well:
 {% highlight php %}
 
 <?php
-$post = $I->grabFromDatabase('posts', ['num_comments >=' => 100]);
-$user = $I->grabFromDatabase('users', ['email like' => 'miles%']);
+$postNum = $I->grabFromDatabase('posts', 'num_comments', ['num_comments >=' => 100]);
+$mail = $I->grabFromDatabase('users', 'email', ['email like' => 'miles%']);
 
 {% endhighlight %}