how to test specific test class using phpunit in laravel

Question

I want to test specific testClass in my project since there are a lot of test class that's failure and I just want to test one Class at a time.

I've created the test Class in following folder \test\repositories\ApplicationVersionFormat.php :

<?php
use App\Repositories\ApplicationVersionFormat;

class ApplicationVersionFormatTest extends \TestCase
{
  public function testValidFormat()
  {
    $version = '1.2.3';
    $appVersion = new ApplicationVersionFormat();
    $this->assertEquals(true,$appVersion->isValidVersion($version));
  }

  public function testInvalidFormat()
  {
    $version = '11.2.3';
    $appVersion = new ApplicationVersionFormat();
    $this->assertEquals(false,$appVersion->isValidVersion($version));
  }

  public function testInvalidFormat2()
  {
    $version = '1.22.3';
    $appVersion = new ApplicationVersionFormat();
    $this->assertEquals(false,$appVersion->isValidVersion($version));
  }

  public function testInvalidFormat3()
  {
    $version = '1.2.33';
    $appVersion = new ApplicationVersionFormat();
    $this->assertEquals(false,$appVersion->isValidVersion($version));
  }

  public function testInvalidFormat4()
  {
    $version = '11.22.33';
    $appVersion = new ApplicationVersionFormat();
    $this->assertEquals(false,$appVersion->isValidVersion($version));
  }
}

so I've tried this follwing command but none of this works :

phpunit "repositories\AppVersionTest". => Cannot open file "test/repositories/AppVersionTest.php"
phpunit "test\repositories\AppVersionTest". => Cannot open file "test/repositories/AppVersionTest.php"
phpunit --filter "repositories\AppVersionTest". => No tests executed!
phpunit --testsuite "repositories\AppVersionTest". => No tests executed!

any help? thanks

Try checking to some inclusion/exclusion configuration in your phpunit.xml(.dist) files. Can you post this files? — Matteo, Aug 24 '16 at 09:37

score 164 · Accepted Answer · answered Aug 24 '16 at 09:44

164

After trying several ways, I found out that I don't need to include the folder to test the specific test class. This works for me it runs all the test on the class:

phpunit --filter ApplicationVersionFormatTest

I think it's because my ApplicationVersionFormatTest extend The TestCase and return application instance which serves as the "glue" for all the components of Laravel.

answered Aug 24 '16 at 09:44

Gujarat Santana

9,854
17
53
75

1

In addition to the phpunit command, you may use the test Artisan command to run your tests. The Artisan test runner provides verbose test reports in order to ease development and debugging: – Yohanim Jul 30 '21 at 03:03
I've tried to put the whole test namespace, but it didn't work; you should pass the class name only for it to work. – shamaseen Jul 06 '22 at 14:27
You last voted on this answer May 26, 2021 at 13:51. Your vote is now locked in unless this answer is edited. here we come again :) after 2 years – Moode Osman May 29 '23 at 13:52

score 116 · Answer 2 · edited Sep 23 '19 at 07:25

for run phpunit test in laravel by many ways ..

vendor/bin/phpunit --filter methodName className pathTofile.php

vendor/bin/phpunit --filter 'namespace\\directoryName\\className::methodName'

for test single class:

vendor/bin/phpunit tests/Feature/UserTest.php
vendor/bin/phpunit --filter  tests/Feature/UserTest.php
vendor/bin/phpunit --filter 'Tests\\Feature\\UserTest'
vendor/bin/phpunit --filter 'UserTest'

for test single method:

 vendor/bin/phpunit --filter testExample 
 vendor/bin/phpunit --filter 'Tests\\Feature\\UserTest::testExample'
 vendor/bin/phpunit --filter testExample UserTest tests/Feature/UserTest.php

for run tests from all class within namespace:

vendor/bin/phpunit --filter 'Tests\\Feature'

for more way run test see more

`vendor/bin/phpunit --filter tests/Feature/UserTest.php` returns to test excuted in my case. — shamaseen, Jul 07 '22 at 12:10

score 89 · Answer 3 · edited Jul 09 '21 at 07:42

89

To do the same thing using artisan run:

php artisan test --filter ApplicationVersionFormatTest

edited Jul 09 '21 at 07:42

linktoahref

7,812
3
29
51

answered Aug 10 '20 at 20:45

tbone1000

1,000
6
4

1

In my case it works with the default Feature and Unit folders, but if i create a new testsuite, it does not work . – Berni Dec 21 '21 at 15:43
@Berni make sure your newly added test class ends with Test, else PHPUnit will not recognize it. – osemec Jan 23 '22 at 21:22
@Berni be sure to add the new test suite to your phpunit.xml file. – tbone1000 Jun 10 '22 at 14:19

score 30 · Answer 4 · answered Aug 19 '21 at 12:11

30

For newer version this might work

php artisan test --filter {MethodName}

// for instance
php artisan test --filter test_example

OR

php artisan test --filter {ClassName}::{MethodName}

//for instance
php artisan test --filter ExampleTest::test_example

answered Aug 19 '21 at 12:11

Osman Rafi

938
1
16
37

1

What about filtering by directory? – Berni Dec 21 '21 at 15:42

score 10 · Answer 5 · edited May 23 '17 at 12:10

10

You can probably manage that with this answer to a related question.

Just mark the class with @group annotation and run PHPUnit with --group <group_name>

Update

Your command with --filter is not complete. Try this: phpunit --filter AppVersionTest "repositories\ApplicationVersionFormat.php"

edited May 23 '17 at 12:10

Community

1
1

answered Aug 24 '16 at 08:47

BVengerov

2,947
1
18
32

score 5 · Answer 6 · answered Apr 02 '22 at 08:41

5

For laravel 8

php artisan test --filter ExampleTest

answered Apr 02 '22 at 08:41

Edham Rabuan

51
1
1

score 1 · Answer 7 · answered Oct 17 '17 at 08:06

1

phpunit --filter <relative_path_to_file> for example , files to test are,test/repos/EloquentPushTest.php,test/repos/EloquentWebTest.php for testing EloquentWebTest.php

use phpunit --filter ./repos/ElqouentWebpush

answered Oct 17 '17 at 08:06

Bhuvaneshwar Nagaraj

33
4

score 1 · Answer 8 · answered Nov 29 '18 at 07:39

1

Example of use:

php phpunit-5.7.27.phar -c app/ "src/package/TestBundle/Tests/Controller/ExampleControllerTest.php"

answered Nov 29 '18 at 07:39

joan16v

5,055
4
49
49

score 0 · Answer 9 · answered Jan 14 '20 at 13:33

Using phpunit.xml

the @group option can be used on classes and methods.

class A

/**
 * @group active
 * */
class ArrayShiftRightTest extends TestCase
{
}

class B

/**
 * @group inactive
 * */
class BinaryGapTest extends TestCase
{    
}

in phpunit.xml

<groups>
    <include>
        <group>active</group>
    </include>
    <exclude>
        <group>inactive</group>
    </exclude>
</groups>

the classes that belongs to group active will be executed.

how to test specific test class using phpunit in laravel

9 Answers9