Updated module docs and changelog

Author: Naktibalda

_includes/extensions.md

@@ -2,7 +2,7 @@
 
 ## DotReporter
 
-[See Source](https://github.com/Codeception/Codeception/blob/4.1/ext/DotReporter.php)
+[See Source](https://github.com/Codeception/Codeception/blob/4.2/ext/DotReporter.php)
 
 DotReporter provides less verbose output for test execution.
 Like PHPUnit printer it prints dots "." for successful testes and "F" for failures.
@@ -38,7 +38,7 @@ Use this extension as an example for building custom reporters.
 
 ## Logger
 
-[See Source](https://github.com/Codeception/Codeception/blob/4.1/ext/Logger.php)
+[See Source](https://github.com/Codeception/Codeception/blob/4.2/ext/Logger.php)
 
 Log suites/tests/steps using Monolog library.
 Monolog should be installed additionally by Composer.
@@ -66,9 +66,9 @@ extensions:
 
 ## Recorder
 
-[See Source](https://github.com/Codeception/Codeception/blob/4.1/ext/Recorder.php)
+[See Source](https://github.com/Codeception/Codeception/blob/4.2/ext/Recorder.php)
 
-Saves a screenshot of each step in acceptance tests and shows them as a slideshow on one HTML page (here's an [example](http://codeception.com/images/recorder.gif))
+Saves a screenshot of each step in acceptance tests and shows them as a slideshow on one HTML page (here's an [example](https://codeception.com/images/recorder.gif))
 Activated only for suites with WebDriver module enabled.
 
 The screenshots are saved to `tests/_output/record_*` directories, open `index.html` to see them as a slideshow.
@@ -125,7 +125,7 @@ public function testLogin(AcceptanceTester $I)
 
 ## RunBefore
 
-[See Source](https://github.com/Codeception/Codeception/blob/4.1/ext/RunBefore.php)
+[See Source](https://github.com/Codeception/Codeception/blob/4.2/ext/RunBefore.php)
 
 Extension for execution of some processes before running tests.
 
@@ -156,7 +156,7 @@ HINT: you can use different configurations per environment.
 
 ## RunFailed
 
-[See Source](https://github.com/Codeception/Codeception/blob/4.1/ext/RunFailed.php)
+[See Source](https://github.com/Codeception/Codeception/blob/4.2/ext/RunFailed.php)
 
 Saves failed tests into tests/_output/failed in order to rerun failed tests.
 
@@ -185,7 +185,7 @@ On each execution failed tests are logged and saved into `tests/_output/failed`
 
 ## RunProcess
 
-[See Source](https://github.com/Codeception/Codeception/blob/4.1/ext/RunProcess.php)
+[See Source](https://github.com/Codeception/Codeception/blob/4.2/ext/RunProcess.php)
 
 Extension to start and stop processes per suite.
 Can be used to start/stop selenium server, chromedriver, mailcatcher, etc.
@@ -232,7 +232,7 @@ HINT: you can use different configurations per environment.
 
 ## SimpleReporter
 
-[See Source](https://github.com/Codeception/Codeception/blob/4.1/ext/SimpleReporter.php)
+[See Source](https://github.com/Codeception/Codeception/blob/4.2/ext/SimpleReporter.php)
 
 This extension demonstrates how you can implement console output of your own.
 Recommended to be used for development purposes only.

changelog.markdown

@@ -32,7 +32,7 @@ Warning. Using PHAR file and composer in the same project can cause unexpected e
 
 
 
-This module interacts with the [Alternative PHP Cache (APC)](https://php.net/manual/en/intro.apcu.php)
+This module interacts with the [Alternative PHP Cache (APC)](http://php.net/manual/en/intro.apcu.php)
 using either _APCu_ or _APC_ extension.
 
 Performs a cleanup by flushing all values after each test run.

docs/modules/Apc.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()](https://codeception.com/docs/modules/Db#seeInDatabase)
+This module also provides actions to perform checks in a database, e.g. [seeInDatabase()](http://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,14 +67,14 @@ 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 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)
+* 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)
 * 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
 ### Example
 
     modules:
@@ -88,6 +88,7 @@ if you run into problems loading dumps and cleaning databases.
              cleanup: true
              reconnect: true
              waitlock: 10
+             skip_cleanup_if_failed: true
              ssl_key: '/path/to/client-key.pem'
              ssl_cert: '/path/to/client-cert.pem'
              ssl_ca: '/path/to/ca-cert.pem'
@@ -390,7 +391,8 @@ Returns the number of rows in a database
 
 #### haveInDatabase
 
-Inserts an SQL record into a database. This record will be erased after the test.
+Inserts an SQL record into a database. This record will be erased after the test, 
+unless you've configured "skip_cleanup_if_failed", and the test fails. 
 
 {% highlight php %}
 

docs/modules/Db.md

@@ -32,7 +32,7 @@ Warning. Using PHAR file and composer in the same project can cause unexpected e
 
 
 
-Access the database using [Doctrine2 ORM](https://docs.doctrine-project.org/projects/doctrine-orm/en/latest/).
+Access the database using [Doctrine2 ORM](http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/).
 
 When used with Symfony or Zend Framework 2, Doctrine's Entity Manager is automatically retrieved from Service Locator.
 Set up your `functional.suite.yml` like this:

docs/modules/Doctrine2.md

@@ -50,9 +50,9 @@ Supported and tested FTP types are:
 * SFTP
 
 Connection uses php build in FTP client for FTP,
-connection to SFTP uses [phpseclib](https://phpseclib.sourceforge.net/) pulled in using composer.
+connection to SFTP uses [phpseclib](http://phpseclib.sourceforge.net/) pulled in using composer.
 
-For SFTP, add [phpseclib](https://phpseclib.sourceforge.net/) to require list.
+For SFTP, add [phpseclib](http://phpseclib.sourceforge.net/) to require list.
 {% highlight yaml %}
 "require": {
  "phpseclib/phpseclib": "^2.0.14"

docs/modules/FTP.md

@@ -32,7 +32,7 @@ Warning. Using PHAR file and composer in the same project can cause unexpected e
 
 
 
-Connects to [memcached](https://www.memcached.org/) using either _Memcache_ or _Memcached_ extension.
+Connects to [memcached](http://www.memcached.org/) using either _Memcache_ or _Memcached_ extension.
 
 Performs a cleanup by flushing all values after each test run.
 

docs/modules/Memcache.md

@@ -32,7 +32,7 @@ Warning. Using PHAR file and composer in the same project can cause unexpected e
 
 
 
-This module provides integration with [Phalcon framework](https://www.phalcon.io/) (3.x).
+This module provides integration with [Phalcon framework](http://www.phalcon.io/) (3.x).
 Please try it and leave your feedback.
 
 ### Demo Project

docs/modules/Phalcon.md

@@ -32,7 +32,7 @@ Warning. Using PHAR file and composer in the same project can cause unexpected e
 
 
 
-This module provides integration with [Phalcon framework](https://www.phalcon.io/) (4.x).
+This module provides integration with [Phalcon framework](http://www.phalcon.io/) (4.x).
 Please try it and leave your feedback.
 
 ### Status

docs/modules/Phalcon4.md

@@ -32,7 +32,7 @@ Warning. Using PHAR file and composer in the same project can cause unexpected e
 
 
 
-Uses [Guzzle](https://guzzlephp.org/) to interact with your application over CURL.
+Uses [Guzzle](http://guzzlephp.org/) to interact with your application over CURL.
 Module works over CURL and requires **PHP CURL extension** to be enabled.
 
 Use to perform web acceptance tests with non-javascript browser.
@@ -50,13 +50,13 @@ If test fails stores last shown page in 'output' dir.
 
 * url *required* - start url of your app
 * headers - default headers are set before each test.
-* handler (default: curl) -  Guzzle handler to use. By default curl is used, also possible to pass `stream`, or any valid class name as [Handler](https://docs.guzzlephp.org/en/latest/handlers-and-middleware.html#handlers).
+* handler (default: curl) -  Guzzle handler to use. By default curl is used, also possible to pass `stream`, or any valid class name as [Handler](http://docs.guzzlephp.org/en/latest/handlers-and-middleware.html#handlers).
 * middleware - Guzzle middlewares to add. An array of valid callables is required.
 * curl - curl options
 * cookies - ...
 * auth - ...
 * verify - ...
-* .. those and other [Guzzle Request options](https://docs.guzzlephp.org/en/latest/request-options.html)
+* .. those and other [Guzzle Request options](http://docs.guzzlephp.org/en/latest/request-options.html)
 
 
 #### Example (`acceptance.suite.yml`)
@@ -91,7 +91,7 @@ Those properties and methods are expected to be used in Helper classes:
 
 Properties:
 
-* `guzzle` - contains [Guzzle](https://guzzlephp.org/) client instance: `\GuzzleHttp\Client`
+* `guzzle` - contains [Guzzle](http://guzzlephp.org/) client instance: `\GuzzleHttp\Client`
 * `client` - Symfony BrowserKit instance.
 
 
@@ -639,7 +639,7 @@ $I->dontSeeResponseCodeIs(\Codeception\Util\HttpCode::OK);
 #### executeInGuzzle
 
 Low-level API method.
-If Codeception commands are not enough, use [Guzzle HTTP Client](https://guzzlephp.org/) methods directly
+If Codeception commands are not enough, use [Guzzle HTTP Client](http://guzzlephp.org/) methods directly
 
 Example: