TestCases and Data for LUYA Modules and Components. Makes testing less pain.

Installs: 69 798

Dependents: 76

Suggesters: 0

Security: 0

Stars: 6

Watchers: 7

Forks: 7


3.1.4 2023-08-31 12:19 UTC


Build Status Test Coverage Total Downloads Latest Stable Version Join the chat at

Providing PHPUnit Testcases and a built in Webserver to test your Application, Modules, Components, APIs or Classes.

Whats included?

Test Cases

  • Web application test case
  • Console application test case
  • Server (for APIs) test case
  • CMS Block test case
  • NgRest test case (for model, controller and API)


  • Message file compare trait
  • Migration file check trait


  • ActiveRecord fixture creates the table on loading based from array or rule definition.

See the full Documentation


Add the luyadev/luya-testsuite package to the require-dev section of your composer.json file:

composer require luyadev/luya-testsuite --dev

Create a new folder tests inside your appliation folder and create a test classes:

namespace app\tests;

use Yii;

class MyTest extends \luya\testsuite\cases\WebApplicationTestCase
    public function getConfigArray()
        return [
            'id' => 'mytestapp',
            'basePath' => dirname(__DIR__),
    public function testInstance()
        // add your phpunit tests here, like:
        $this->assertInstanceOf('luya\web\Application', Yii::$app);
        $this->assertInstanceOf('luya\base\Boot', $this->boot);
        $this->assertInstanceOf('luya\web\Application', $this->app);

To run the unit tests while (assuming your tests are in directory tests/) run in your terminal:

./vendor/bin/phpunit tests/

In order to support sqlite fixtures install:

sudo apt-get install php-sqlite3 

Example Test Cases

Some example in how to use the LUYA Testsuite for different scenarios.

Testing API and Application

When working with APIs or Customer Websites somtimes you just want to test the Website itself, what is the response, does all the pages still work after my update? Therefore we have luya\testsuite\cases\ServerTestCase.

This example will run your LUYA application within a PHP Webserver and test the response status codes or contents for a set of given pages. In order to run this example create a MyWebsiteTest.php file inside the tests folder.

namespace app\tests;

class MyWebsiteTest extends ServerTestCase
   public function getConfigArray()
      return [
          'id' => 'mytestapp',
          'basePath' => dirname(__DIR__),
  public function testSites()
      $this->assertUrlHomepageIsOk(); // checks the root url like: http://localhost/
      $this->assertUrlIsOk('about'); // checks: http://localhost/
      $this->assertUrlGetResponseContains('about/me', 'Hello World'); // checks: http://localhost/
      $this->assertUrlIsError('errorpage'); // checks: http://localhost/

As the Webserver process may run from a different permission level you have to ensure the assets/runtime folder has the required permissions.

Controller Function Test

We're using getMockBuilder() as shown in the multiple examples in the PHPUnit to setup the DefaultController and assert the registered module addressbook. To test the the runtime exception (caused by a database error), we use the mock method function:

public function testActionIndex()
    $module = Yii::$app->getModule('addressbook');
    $this->assertInstanceOf('luya\addressbook\frontend\Module', $module);
    $mock = $this->getMockBuilder(DefaultController::class)
        ->setConstructorArgs(["id" => "default", "module" => $module])