{"id":71481,"date":"2025-04-23T18:31:21","date_gmt":"2025-04-23T13:01:21","guid":{"rendered":"https:\/\/www.tothenew.com\/blog\/?p=71481"},"modified":"2025-07-30T13:18:09","modified_gmt":"2025-07-30T07:48:09","slug":"how-to-run-phpunit-tests-efficiently-in-drupal","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/how-to-run-phpunit-tests-efficiently-in-drupal\/","title":{"rendered":"How to run PHPUnit tests efficiently in Drupal 10\/11?"},"content":{"rendered":"

Introduction<\/h2>\n

Do you know how important writing test cases for your functionalities you are developing is? Drupal always supports and gives an easy way to write test cases because it’s a vital part of development. It always helps in to early detection of bugs before deployment and also helps us to understand the code structure in a better way and the understanding of the business use cases.<\/p>\n

In this article, we will understand How Efficiently we can run a test case using the PHPUnit framework in Drupal 10 and Drupal 11<\/strong>. Also, we will explore all the steps starting with installing the PHPUnit module via Composer, then we will understand what the necessary changes are in its configuration file, where we should locate this file, and then we will check a working example of writing a test case and how many ways we can run our test case.<\/p>\n

\"unittest<\/a>

PHPUnit in Drupal<\/p><\/div>\n

Here is the step-by-step process to write and run PHPUnit test cases in Drupal:<\/h2>\n

Step 1: Install PHPUnit in Drupal<\/h3>\n

Install the PHPUnit module via below command:<\/p>\n

composer require --dev phpunit\/phpunit<\/strong><\/pre>\n
Executing this command adds PHPUnit to your project\u2019s development dependencies.<\/p>\n
Step 2:Configure the phpunit.xml file<\/strong><\/h3>\n
PHPUnit.xml.dist is the default PHPUnit configuration file included with Drupal core. Just copy this file to the root directory of your Drupal project and rename it phpunit.xml to begin using it. The command for this is as follows:<\/p>\n
If your Drupal 10\/11 doesn’t have a web folder, then run below command:<\/p>\n
cp core\/phpunit.xml.dist phpunit.xml<\/strong><\/pre>\n
If your Drupal 10\/11 have a web folder, then run below command:<\/p>\n
cp web\/core\/phpunit.xml.dist web\/phpunit.xml<\/strong><\/pre>\n
In this configuration file, you can define test suite directories, test files, bootstrap files, environment variables, and other settings.<\/p>\n
Update this PHPUnit configuration file as per your requirement:<\/p>\n
Add the module test class path as an example below. Here we have 2 types of test cases written, Unit Test cases and Functional Test cases. For each test type, you have to mention each module test class path.<\/p>\n
Here, we have both Unit<\/strong> and Functional<\/strong> Test Cases<\/strong>. This can be any sort of test type based on your requirements. You need to mention the correct test class path, and mention under test type tags separately<\/p>\n
NOTE:<\/strong> In the phpunit.xml file, under the <testsuites> tag, please remove unused test suites for any other tests, like functional\/Kernel or any other if they have not currently been written, because if you keep those configurations, it will give you errors on running the whole test suite.<\/p>\n
<phpunit bootstrap=\"core\/tests\/bootstrap.php\"<\/strong>\r\n         colors=\"true\"<\/strong>\r\n         verbose=\"true\"<\/strong>\r\n         stopOnFailure=\"false\"><\/strong>\r\n   <testsuites>\r\n      <testsuite name=\"Custom Unit Tests\">\r\n        <directory>modules\/custom\/myexample_grlogger\/tests\/src\/Unit<\/directory>\r\n        <directory>modules\/custom\/string_matcher\/tests\/src\/Unit<\/directory>\r\n   <\/testsuite>\r\n   <testsuite name=\"Functional Unit Tests\">\r\n        <directory>modules\/custom\/myexample_grlogger\/tests\/src\/Functional<\/directory>\r\n        <directory>modules\/custom\/string_matcher\/tests\/src\/Functional<\/directory>\r\n   <\/testsuite>\r\n<\/testsuites><\/strong>\r\n<\/phpunit><\/strong><\/pre>\n
Also, confirm if the core\/tests\/bootstrap.php file exists, and the path of the bootstrap file must be as below :<\/p>\n
<phpunit bootstrap=\"core\/tests\/bootstrap.php\" \r\n ...\r\n<testsuites>\r\n...<\/pre>\n
This will be the same in Drupal 10 and Drupal 11 and whether your project folder contains a web folder for core and other files, or there is no web folder in your Drupal project folder.<\/p>\n
Step 3: Example: Create a custom module to write and run the test case:<\/h3>\n
We have taken an example of a use case where we need to enforce business rules for a service that compares two strings and logs messages in Drupal, creating a maintainable solution with PHPUnit-tested services, configurable discount tiers, and audit logging capabilities.<\/p>\n
To\u00a0help\u00a0you\u00a0understand\u00a0the\u00a0folder\u00a0structure,\u00a0here\u00a0is\u00a0an\u00a0example\u00a0of\u00a0a\u00a0file\u00a0and\u00a0folder\u00a0structure.<\/p>\n
\"PHPUnit
Folder Structure<\/p><\/div>\n
Step 4: Construct a custom Service<\/strong><\/h3>\n
This service compares two strings and logs messages in Drupal.<\/p>\n
File path: modules\/custom\/string_matcher\/src\/Service\/StringComparerService.php<\/strong><\/p>\n
namespace Drupal\\string_matcher\\Service;\r\n\r\nuse Psr\\Log\\LoggerInterface;\r\nuse Drupal\\Core\\Logger\\LoggerChannelFactoryInterface;\r\n\r\nclass StringComparerService {\r\n\r\n  protected LoggerInterface $logger;\r\n  public function __construct(LoggerChannelFactoryInterface $logger_factory) {\r\n    $this->logger = $logger_factory->get('string_matcher');\r\n  }\r\n\r\n \/**\r\n  * Compares two strings and logs the result.\r\n  *\/\r\n  public function isEqual(string $a, string $b): bool {\r\n    $result = $a === $b;\r\n    $this->logger->info('Comparing strings: \"@a\" and \"@b\" => @result', [\r\n      '@a' => $a,\r\n      '@b' => $b,\r\n      '@result' => $result ? 'Match' : 'No Match',\r\n    ]);\r\n  return $result;\r\n  }\r\n}<\/pre>\n
Step 5: Add the Service by *.service.yml config file<\/strong><\/h3>\n
File: modules\/custom\/string_matcher\/string_matcher.services.yml<\/strong><\/p>\n
services:\r\n  string_matcher.comparer:\r\n    class: Drupal\\string_matcher\\StringComparerService\r\n    arguments: ['@logger.factory']<\/pre>\n
Step 6: Write a Unit test for the Drupal Service StringComparerService service<\/strong><\/h3>\n
Writing the test for the custom service method is the last step. We\u2019ll mock dependencies (if any) and test edge cases.<\/p>\n
File: modules\/custom\/string_matcher\/tests\/src\/Unit\/StringComparerServiceTest.php<\/strong><\/p>\n
namespace Drupal\\Tests\\string_matcher\\Unit;\r\n\r\nuse Drupal\\Core\\Logger\\LoggerChannelFactoryInterface;\r\nuse Drupal\\Core\\Logger\\LoggerChannelInterface;\r\nuse Drupal\\string_matcher\\Service\\StringComparerService;\r\nuse PHPUnit\\Framework\\TestCase;\r\n\r\nclass StringComparerServiceTest extends TestCase {\r\n\r\nprotected $loggerFactoryMock;\r\nprotected $loggerMock;\r\nprotected $service;\r\n\r\nprotected function setUp(): void {\r\n  parent::setUp();\r\n  $this->loggerMock = $this->createMock(LoggerChannelInterface::class);\r\n  $this->loggerMock->expects($this->any())\r\n   ->method('info');\r\n\r\n  $this->loggerFactoryMock = $this->createMock(LoggerChannelFactoryInterface::class);\r\n  $this->loggerFactoryMock->expects($this->any())\r\n    ->method('get')\r\n    ->with('string_matcher')\r\n    ->willReturn($this->loggerMock);\r\n\r\n  $this->service = new StringComparerService($this->loggerFactoryMock);\r\n }\r\n\r\n public function testStringsAreEqual() {\r\n  $this->assertTrue($this->service->isEqual('hello', 'hello'));\r\n }\r\n\r\n public function testStringsAreNotEqual() {\r\n  $this->assertFalse($this->service->isEqual('hello', 'world'));\r\n }\r\n}<\/pre>\n
Step 7: Run the\u00a0 Testcases using PHPUnit in Drupal 10\/11<\/h3>\n
Run all commands below in the Drupal project root directory. If there is a web folder (maybe in Drupal 11) then run these commands outside web folder.<\/p>\n
    \n
  1. Running the Test Suite<\/strong><\/li>\n<\/ol>\n
    In Drupal 10, initiate the test runner with this terminal command<\/p>\n
    Here, in Drupal 10, we have used php8.2 and PHPUnit 9.5\r\n.\/vendor\/bin\/phpunit<\/pre>\n
    For Drupal 11, initiate the test runner with this terminal command<\/p>\n
    In Drupal 11, we are using php8.3,  PHPUnit 10.5+, for this we can run the above command in either ways below:\r\n\r\nCommand1 =>     .\/vendor\/bin\/phpunit --configuration web\/phpunit.xml\r\n \r\nCommand2  =>    .\/vendor\/bin\/phpunit -c web\/phpunit.xml<\/pre>\n
    Without requiring you to specify specific test files, this will automatically find and run every test file you have indicated in your setup.<\/p>\n
    This command’s result is displayed below:<\/p>\n
    \"PHPUnit
    Run Test suite<\/p><\/div>\n
    2. Running a Specific Test File<\/strong><\/p>\n
    Use\u00a0this\u00a0command\u00a0to\u00a0run\u00a0tests\u00a0from\u00a0a\u00a0specific\u00a0file\u00a0(such\u00a0as\u00a0one\u00a0that\u00a0has\u00a0several\u00a0test\u00a0cases\u00a0pertaining\u00a0to\u00a0a\u00a0single\u00a0service\u00a0or\u00a0class):<\/p>\n
    In Drupal 10, run below command for single file:<\/strong>\r\n\r\n.\/vendor\/bin\/phpunit modules\/custom\/string_matcher\/tests\/src\/Unit\/StringComparerServiceTest.php<\/pre>\n
    In Drupal 11, run below command for single file:<\/strong>\r\n\r\n.\/vendor\/bin\/phpunit -c web\/phpunit.xml web\/modules\/custom\/string_matcher\/tests\/src\/Unit\/StringComparerServiceTest.php<\/pre>\n
    The above command will run a single test file for all test cases. For this example, we have 2 test cases that will run by below command.<\/p>\n
    The outcome of this command is shown below:<\/p>\n
    \"PHPUnit
    Run by PHPUnit Single File<\/p><\/div>\n
    3. Running a Specific Test Method<\/strong><\/p>\n
    If you need to run just a single method from a test class, you can make use of PHPUnit\u2019s –filter option to do so.<\/p>\n
    In Drupal 10, use below command to run single function in a test file:\r\n\r\n.\/vendor\/bin\/phpunit --filter testStringsAreEqual<\/pre>\n
    In Drupal 11, use below command to run single function in a test file:\r\n\r\n.\/vendor\/bin\/phpunit -c web\/phpunit.xml --filter StringComparerServiceTest::testStringsAreEqual<\/pre>\n
    This command will run a single testcase, and this helps save time when troubleshooting.<\/p>\n
    The outcome of this command is shown below:<\/p>\n
    \"PHPUnit
    Run by PHPUnit Single Function<\/p><\/div>\n
    Conclusion<\/h3>\n
    Test Cases help in future code refactoring, new feature development, changes to existing features, early bug detection, faster development, and many more. A successful writing Unit Test in Drupal CMS primarily depends on how effectively you apply best practices and how much of your code is reusable, and how many scenarios are handled. This method of writing code allows you to create better tests with less work and achieve excellent outcomes.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Introduction Do you know how important writing test cases for your functionalities you are developing is? Drupal always supports and gives an easy way to write test cases because it’s a vital part of development. It always helps in to early detection of bugs before deployment and also helps us to understand the code structure […]<\/p>\n","protected":false},"author":1508,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":231},"categories":[3602],"tags":[4862,5400,6421,7247],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/71481"}],"collection":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/users\/1508"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/comments?post=71481"}],"version-history":[{"count":77,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/71481\/revisions"}],"predecessor-version":[{"id":73740,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/71481\/revisions\/73740"}],"wp:attachment":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/media?parent=71481"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/categories?post=71481"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/tags?post=71481"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}