PHP unit testing

Installation Extensions API Reference Feedback 📣
Search…
PHP unit testing
Overview
In this guide you'll learn how to create PHPUnit tests in Shopware 6. You can read more about PHP unit testing at the official PHPUnit documentation. 
Documentation for PHPUnit – The PHP Testing Framework
Throughout this guide, you will find the $ symbol representing your command line.
Prerequisites
In order to create tests for your plugin, you first need a plugin as base. Therefore, you can refer to the Plugin Base Guide.
Furthermore, you should have a look at our Execute database queries / migrations guide since this guide will show you how to create a migration test for these example.
PHPUnit configuration
First of all we have to configure PHPUnit a bit. Therefore we have to create a file called phpunit.xml.dist in the root directory of our plugin. To get more familiar with the configurable options, you can refer to the PHPUnit documentation. In this example we configure PHPUnit to search in the directories <plugin root>/src/Test and <plugin root>/src/Migration/Test for our tests.
Here's an example configuration for the development template:
<plugin root>/phpunit.xml.dist
1
<?xml version="1.0" encoding="UTF-8"?>
2
​
3
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4
         xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/7.1/phpunit.xsd"
5
         bootstrap="../../../vendor/shopware/platform/src/Core/TestBootstrap.php"
6
         cacheResult="false">
7
​
8
    <php>
9
        <ini name="error_reporting" value="-1"/>
10
        <server name="KERNEL_CLASS" value="Shopware\Development\Kernel"/>
11
        <env name="APP_ENV" value="test"/>
12
        <env name="APP_DEBUG" value="1"/>
13
        <env name="APP_SECRET" value="s$cretf0rt3st"/>
14
        <env name="SHELL_VERBOSITY" value="-1"/>
15
    </php>
16
​
17
    <testsuites>
18
        <testsuite name="Example Testsuite">
19
            <directory>src/Test</directory>
20
        </testsuite>
21
​
22
        <testsuite name="migration">
23
            <directory>src/Migration/Test</directory>
24
        </testsuite>
25
    </testsuites>
26
​
27
    <filter>
28
        <whitelist>
29
            <directory suffix=".php">./</directory>
30
        </whitelist>
31
    </filter>
32
</phpunit>
Copied!
Example Tests
Integration test
After we've configured PHPUnit, we can start writing our first test. In this example we have a test which simply tries to instantiate every .php class, to see if any used core classes went missing. In our test we use the IntegrationTestBehaviour trait which comes in with some handy features, such as automatically setting up a database transaction or clearing the cache before starting your tests.
Therefore, this is how your service could then look like:
<plugin root>/src/Test/UsedClassesAvailableTest.php
1
<?php declare(strict_types=1);
2
​
3
namespace Swag\BasicExample\Test;
4
​
5
use PHPUnit\Framework\TestCase;
6
use Shopware\Core\Framework\Test\TestCaseBase\IntegrationTestBehaviour;
7
use Symfony\Component\Finder\Finder;
8
​
9
class UsedClassesAvailableTest extends TestCase
10
{
11
    use IntegrationTestBehaviour;
12
​
13
    public function testClassesAreInstantiable(): void
14
    {
15
        $namespace = str_replace('\Test', '', __NAMESPACE__);
16
​
17
        foreach ($this->getPluginClasses() as $class) {
18
            $classRelativePath = str_replace(['.php', '/'], ['', '\\'], $class->getRelativePathname());
19
​
20
            $this->getMockBuilder($namespace . '\\' . $classRelativePath)
21
                ->disableOriginalConstructor()
22
                ->getMock();
23
        }
24
​
25
        // Nothing broke so far, classes seem to be instantiable
26
        $this->assertTrue(true);
27
    }
28
​
29
    private function getPluginClasses(): Finder
30
    {
31
        $finder = new Finder();
32
        $finder->in(realpath(__DIR__ . '/../'));
33
        $finder->exclude('Test');
34
        return $finder->files()->name('*.php');
35
    }
36
}
Copied!
Migration test
In order to test our example migration Migration1611740369ExampleDescription, we create a new test called Migration1611740369ExampleDescriptionTest which extends from the PHPUnit TestCase. Furthermore we use the KernelTestBehaviour trait since we need our database connection from the container.
Here's an example for a migration test:
<plugin root>/src/Migration/Test/Migration1611740369ExampleDescriptionTest.php
1
<?php declare(strict_types=1);
2
​
3
namespace Swag\BasicExample\Migration\Test;
4
​
5
use Doctrine\DBAL\Connection;
6
use PHPUnit\Framework\TestCase;
7
use Shopware\Core\Framework\Test\TestCaseBase\KernelTestBehaviour;
8
​
9
class Migration1611740369ExampleDescriptionTest extends TestCase
10
{
11
    use KernelTestBehaviour;
12
​
13
    public function testNoChanges(): void
14
    {
15
        /** @var Connection $conn */
16
        $conn = $this->getContainer()->get(Connection::class);
17
        $expectedSchema = $conn->fetchAssoc('SHOW CREATE TABLE `swag_basic_example_general_settings`')['Create Table'];
18
​
19
        $migration = new Migration1611740369ExampleDescription();
20
​
21
        $migration->update($conn);
22
        $actualSchema = $conn->fetchAssoc('SHOW CREATE TABLE `swag_basic_example_general_settings`')['Create Table'];
23
        static::assertSame($expectedSchema, $actualSchema, 'Schema changed!. Run init again to have clean state');
24
​
25
        $migration->updateDestructive($conn);
26
        $actualSchema = $conn->fetchAssoc('SHOW CREATE TABLE `swag_basic_example_general_settings`')['Create Table'];
27
        static::assertSame($expectedSchema, $actualSchema, 'Schema changed!. Run init again to have clean state');
28
    }
29
​
30
    public function testNoTable(): void
31
    {
32
        /** @var Connection $conn */
33
        $conn = $this->getContainer()->get(Connection::class);
34
        $conn->executeStatement('DROP TABLE `swag_basic_example_general_settings`');
35
​
36
        $migration = new Migration1611740369ExampleDescription();
37
        $migration->update($conn);
38
        $exists = $conn->fetchColumn('SELECT COUNT(*) FROM `swag_basic_example_general_settings`') !== false;
39
​
40
        static::assertTrue($exists);
41
    }
42
}
Copied!
Database setup
Once we've created our tests, we have to initialize the test databases for our migration test. This can be done with the following command:
1
$ ./psh.phar init-test-databases
Copied!
Executing the test
All commands in this section will be executed in the root directory of our plugin.
For easier usage, you could create a batch file called phpunit.sh into a /bin directory of your plugin. Its only purpose then would be executing the PHPUnit testsuite. Make sure the path in the following file actually fits.
<plugin root>/bin/phpunit.sh
1
#!/usr/bin/env bash
2
./../../../vendor/bin/phpunit "[email protected]"
Copied!
Executing all tests in the plugin
Now we can execute the phpunit.sh to run all tests of our plugin.
1
$ ./bin/phpunit.sh
Copied!
Executing a single test
If we want to execute a specific test only, we have to pass the path to the test as argument.
1
$ ./bin/phpunit.sh src/Migration/Test/Migration1611740369ExampleDescriptionTest.php
Copied!
Executing a single method
To execute a specific method of a test, we have to pass the argument --filter with the name of the method and the path to test.
1
$ ./bin/phpunit.sh --filter testNoChanges src/Migration/Test/Migration1611740369ExampleDescriptionTest.php
Copied!
Production template
If you use the production template (which is also used by the zipped download version), you have to change a few things. First the path to the bootstrap file is different, because there's no shopware/platform, but shopware/core. So we have to change vendor/shopware/platform/src/Core/TestBootstrap.php to vendor/shopware/core/TestBootstrap.php.
We also need to change the KERNEL_CLASS from Shopware\Development\Kernel to Shopware\Production\Kernel.
Therefore, this is how your configuration could then look like:
<plugin root>/phpunit.xml.dist
1
<?xml version="1.0" encoding="UTF-8"?>
2
​
3
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4
         xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/7.1/phpunit.xsd"
5
         bootstrap="../../../vendor/shopware/core/TestBootstrap.php"
6
         cacheResult="false">
7
​
8
    <php>
9
        <ini name="error_reporting" value="-1"/>
10
        <server name="KERNEL_CLASS" value="Shopware\Production\Kernel"/>
11
        <env name="APP_ENV" value="test"/>
12
        <env name="APP_DEBUG" value="1"/>
13
        <env name="APP_SECRET" value="s$cretf0rt3st"/>
14
        <env name="SHELL_VERBOSITY" value="-1"/>
15
    </php>
16
​
17
    <testsuites>
18
        <testsuite name="Example Testsuite">
19
            <directory>src/Test</directory>
20
        </testsuite>
21
​
22
        <testsuite name="migration">
23
            <directory>src/Migration/Test</directory>
24
        </testsuite>
25
    </testsuites>
26
​
27
    <filter>
28
        <whitelist>
29
            <directory suffix=".php">./</directory>
30
        </whitelist>
31
    </filter>
32
</phpunit>
Copied!
Next steps
You've learned about PHPUnit tests here now. But what about unit testing your javascript code, either in the storefront or the administration?
​Jest unit tests in Shopware's administration​
​Jest unit tests in Shopware's storefront​
Jest unit tests in Shopware's storefront
Themes
Last modified 7mo ago
Copy link
Edit on GitHub
Contents
Overview
Prerequisites
PHPUnit configuration
Executing all tests in the plugin
Executing a single test
Executing a single method
Production template
Next steps