quality-testing

Drupal Quality & Testing

PHPUnit Test Types

Unit Tests

• Location: tests/src/Unit/
• Extend: Drupal\Tests\UnitTestCase
• No Drupal bootstrap, no database
• Mock all dependencies with $this->createMock() or Prophecy

namespace Drupal\Tests\MODULE_NAME\Unit;

use Drupal\Tests\UnitTestCase;

class MyServiceTest extends UnitTestCase {

  public function testSomething(): void {
    $mock = $this->createMock(SomeInterface::class);
    $mock->method('getValue')->willReturn('test');
    $service = new MyService($mock);
    $this->assertEquals('expected', $service->process());
  }

}

Kernel Tests

• Location: tests/src/Kernel/
• Extend: Drupal\KernelTests\KernelTestBase
• Minimal bootstrap with database and services

namespace Drupal\Tests\MODULE_NAME\Kernel;

use Drupal\KernelTests\KernelTestBase;

class MyServiceKernelTest extends KernelTestBase {

  protected static $modules = ['system', 'user', 'node', 'MODULE_NAME'];

  protected function setUp(): void {
    parent::setUp();
    $this->installEntitySchema('user');
    $this->installEntitySchema('node');
    $this->installConfig(['system', 'MODULE_NAME']);
  }

  public function testServiceIntegration(): void {
    $service = $this->container->get('MODULE_NAME.my_service');
    $this->assertNotNull($service);
  }

}

Functional Tests

• Location: tests/src/Functional/
• Extend: Drupal\Tests\BrowserTestBase
• Full Drupal install, simulated browser

namespace Drupal\Tests\MODULE_NAME\Functional;

use Drupal\Tests\BrowserTestBase;

class MyPageTest extends BrowserTestBase {

  protected static $modules = ['MODULE_NAME'];
  protected $defaultTheme = 'stark';

  public function testPageAccess(): void {
    $user = $this->drupalCreateUser(['access content']);
    $this->drupalLogin($user);
    $this->drupalGet('/my-page');
    $this->assertSession()->statusCodeEquals(200);
    $this->assertSession()->pageTextContains('Expected text');
  }

}

Running Tests

# Single test file
ddev exec ./vendor/bin/phpunit -c web/core web/modules/custom/MODULE/tests/src/Unit/MyTest.php

# By group
ddev exec ./vendor/bin/phpunit -c web/core --group MODULE_NAME

# By test type directory
ddev exec ./vendor/bin/phpunit -c web/core web/modules/custom/MODULE/tests/src/Kernel/

# With filter
ddev exec ./vendor/bin/phpunit -c web/core --filter testMethodName