mirror of
https://github.com/wintercms/winter.git
synced 2024-06-28 05:33:29 +02:00
106 lines
4.8 KiB
Markdown
106 lines
4.8 KiB
Markdown
# Plugin testing
|
|
|
|
Individual plugin test cases can be run by running `../../../vendor/bin/phpunit` in the plugin's base directory (ex. `plugins/acme/demo`.
|
|
|
|
### Creating plugin tests
|
|
|
|
Plugins can be tested by creating a file called `phpunit.xml` in the base directory with the following content, for example, in a file **/plugins/acme/blog/phpunit.xml**:
|
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<phpunit backupGlobals="false"
|
|
backupStaticAttributes="false"
|
|
bootstrap="../../../tests/bootstrap.php"
|
|
colors="true"
|
|
convertErrorsToExceptions="true"
|
|
convertNoticesToExceptions="true"
|
|
convertWarningsToExceptions="true"
|
|
processIsolation="false"
|
|
stopOnFailure="false"
|
|
syntaxCheck="false"
|
|
>
|
|
<testsuites>
|
|
<testsuite name="Plugin Unit Test Suite">
|
|
<directory>./tests</directory>
|
|
</testsuite>
|
|
</testsuites>
|
|
<php>
|
|
<env name="APP_ENV" value="testing"/>
|
|
<env name="CACHE_DRIVER" value="array"/>
|
|
<env name="SESSION_DRIVER" value="array"/>
|
|
</php>
|
|
</phpunit>
|
|
|
|
Then a **tests/** directory can be created to contain the test classes. The file structure should mimic the base directory with classes having a `Test` suffix. Using a namespace for the class is also recommended.
|
|
|
|
<?php namespace Acme\Blog\Tests\Models;
|
|
|
|
use Acme\Blog\Models\Post;
|
|
use PluginTestCase;
|
|
|
|
class PostTest extends PluginTestCase
|
|
{
|
|
public function testCreateFirstPost()
|
|
{
|
|
$post = Post::create(['title' => 'Hi!']);
|
|
$this->assertEquals(1, $post->id);
|
|
}
|
|
}
|
|
|
|
The test class should extend the base class `PluginTestCase` and this is a special class that will set up the October database stored in memory, as part of the `setUp` method. It will also refresh the plugin being tested, along with any of the defined dependencies in the plugin registration file. This is the equivalent of running the following before each test:
|
|
|
|
php artisan october:up
|
|
php artisan plugin:refresh Acme.Blog
|
|
[php artisan plugin:refresh <dependency>, ...]
|
|
|
|
> **Note:** If your plugin uses [configuration files](../plugin/settings#file-configuration), then you will need to run `System\Classes\PluginManager::instance()->registerAll(true);` in the `setUp` method of your tests. Below is an example of a base test case class that should be used if you need to test your plugin working with other plugins instead of in isolation.
|
|
|
|
use System\Classes\PluginManager;
|
|
|
|
class BaseTestCase extends PluginTestCase
|
|
{
|
|
public function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
|
|
// Get the plugin manager
|
|
$pluginManager = PluginManager::instance();
|
|
|
|
// Register the plugins to make features like file configuration available
|
|
$pluginManager->registerAll(true);
|
|
|
|
// Boot all the plugins to test with dependencies of this plugin
|
|
$pluginManager->bootAll(true);
|
|
}
|
|
|
|
public function tearDown(): void
|
|
{
|
|
parent::tearDown();
|
|
|
|
// Get the plugin manager
|
|
$pluginManager = PluginManager::instance();
|
|
|
|
// Ensure that plugins are registered again for the next test
|
|
$pluginManager->unregisterAll();
|
|
}
|
|
}
|
|
|
|
#### Changing database engine for plugins tests
|
|
|
|
By default OctoberCMS uses SQLite stored in memory for the plugin testing environment. If you want to override the default behavior set the `useConfigForTesting` config to `true` in your `/config/database.php` file. When the `APP_ENV` is `testing` and the `useConfigForTesting` is `true` database parameters will be taken from `/config/database.php`.
|
|
|
|
You can override the `/config/database.php` file by creating `/config/testing/database.php`. In this case variables from the latter file will be taken.
|
|
|
|
## System testing
|
|
|
|
To perform unit testing on the core October files, you should download a development copy using composer or cloning the git repo. This will ensure you have the `tests/` directory.
|
|
|
|
### Unit tests
|
|
|
|
Unit tests can be performed by running `vendor/bin/phpunit` in the root directory of your October CMS installation.
|
|
|
|
### Functional tests
|
|
|
|
Functional tests can be performed by installing the [RainLab Dusk](https://octobercms.com/plugin/rainlab-dusk) in your October CMS installation. The RainLab Dusk plugin is powered by Laravel Dusk, a comprehensive testing suite for the Laravel framework that is designed to test interactions with a fully operational October CMS instance through a virtual browser.
|
|
|
|
For information on installing and setting up your October CMS install to run functional tests, please review the [README](https://github.com/rainlab/dusk-plugin/blob/master/README.md) for the plugin.
|