PHP测试第五部分（单元测试参数详解）

Love The Way You Lie 2022-03-06 07:46 283阅读 0赞

> 单元测试常用参数

### 文章目录 ###

*   *   *  1. 指定单元测试函数
         *  2. 生成html代码覆盖报告
         *  3. 遇到错误时停止
         *  4. 测试前运行启动文件
         *  5. 指定测试配置文件
         *  6. 输出调试信息
         *  7. 添加PHP.ini配置
         *  8. 批量测试
         *  8. 常用注释测试参数

### 1. 指定单元测试函数 ###

> 使用 `--filter` 参数指定单元测试执行的函数

vendor\bin\phpunit  --filter test_oper

### 2. 生成html代码覆盖报告 ###

> 使用 `--coverage-html` 参数指定生成代码覆盖率的html文件目录

vendor\bin\phpunit --coverage-html  /tmp/log/phpunit

### 3. 遇到错误时停止 ###

vendor\bin\phpunit --stop-on-error

第一次出错或失败时停止

vendor\bin\phpunit --stop-on-failure

### 4. 测试前运行启动文件 ###

> `--bootstrap` 参数常常在测试运行前 先加载指定的依赖文件 常常是composer里的`autoload.php` 文件

vendor\bin\phpunit --bootstrap /vendor/autoload.php

### 5. 指定测试配置文件 ###

> `--configuration` 或者 `-c` 参数指定对应的 `phpunit.xml`文件的路径

### 6. 输出调试信息 ###

vendor\bin\phpunit --debug

### 7. 添加PHP.ini配置 ###

vendor\bin\phpunit -d key[=value]

### 8. 批量测试 ###

> 使用 `@dataProvider`在测试函数的注释中指明测试的数据提供函数 并依次接收所有参数，每组参数的  
> 最后一个是期待的结果值

class CalcControllerTest extends TestCase
    { 
        private $calc;
        public function setUp()
        { 
            parent::setUp(); // TODO: Change the autogenerated stub
            $this->calc = new \App\Http\Controllers\CalcController();
        }
    	/** * @dataProvider operPrider */
    	public function testOper($a,$b,$c,$expected){ 
    	    $this->assertEquals($expected,$this->calc->oper($a,$b,$c));
    	}
    
    	public function operPrider(){ 
    	    return [
    	        [1,2,'+',3],
    	        [3,4,'-',-1],
    	        [4,8,'*',32],
    	        [15,3,'/',5],
    	    ];
    	}
    }

更多细节参考： [https://phpunit.de/manual/6.5/en/writing-tests-for-phpunit.html][https_phpunit.de_manual_6.5_en_writing-tests-for-phpunit.html]

### 8. 常用注释测试参数 ###

<table> 
 <thead> 
  <tr> 
   <th>注释名称</th> 
   <th>注释说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>@author</code></td> 
   <td>是<code>@group</code>的别名</td> 
  </tr> 
  <tr> 
   <td><code>@group</code></td> 
   <td>设置测试使用组</td> 
  </tr> 
  <tr> 
   <td><code>@afterClass</code></td> 
   <td>指明此静态方法应该于测试类中的所有测试方法都运行完成之后调用</td> 
  </tr> 
  <tr> 
   <td><code>@before</code></td> 
   <td>指明此方法应当在测试用例类中的每个测试方法开始运行之前调用</td> 
  </tr> 
  <tr> 
   <td><code>@beforeClass</code></td> 
   <td>指明此静态方法应该于测试类中的所有测试方法都运行完成之前调用</td> 
  </tr> 
  <tr> 
   <td><code>@covers</code></td> 
   <td>指明测试方法想要对哪些方法进行测试</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName::methodName</code></td> 
   <td>指明所标注的测试方法覆盖指定的方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName</code></td> 
   <td>指明所标注的测试方法覆盖给定类的全部方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName&lt;extended&gt;</code></td> 
   <td>指明所标注的测试方法覆盖给定类以及其所有父类与接口的全部方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName::&lt;public&gt;</code></td> 
   <td>指明所标注的测试方法覆盖给定类的所有 public 方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName::&lt;protected&gt;</code></td> 
   <td>指明所标注的测试方法覆盖给定类的所有 protected 方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName::&lt;private&gt;</code></td> 
   <td>指明所标注的测试方法覆盖给定类的所有 private 方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName::&lt;!public&gt;</code></td> 
   <td>指明所标注的测试方法覆盖给定类的所有非 public 方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName::&lt;!protected&gt;</code></td> 
   <td>指明所标注的测试方法覆盖给定类的所有非 protected 方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ClassName::&lt;!private&gt;</code></td> 
   <td>指明所标注的测试方法覆盖给定类的所有非 private 方法。</td> 
  </tr> 
  <tr> 
   <td><code>@covers ::functionName</code></td> 
   <td>指明所标注的测试方法覆盖给定的全局函数。</td> 
  </tr> 
  <tr> 
   <td><code>@coversNothing</code></td> 
   <td>指明不需要记录代码覆盖率信息</td> 
  </tr> 
  <tr> 
   <td><code>@expectedException</code></td> 
   <td>指明期待的异常类型</td> 
  </tr> 
  <tr> 
   <td><code>@expectedExceptionCode</code></td> 
   <td>指明期待的异常错误码</td> 
  </tr> 
  <tr> 
   <td><code>@expectedExceptionMessage</code></td> 
   <td>指明期待的异常错误信息</td> 
  </tr> 
  <tr> 
   <td><code>@expectedExceptionMessageRegExp</code></td> 
   <td>期待的异常错误信息正则</td> 
  </tr> 
  <tr> 
   <td><code>@large</code></td> 
   <td>测试超过 60s会被标记为失败</td> 
  </tr> 
  <tr> 
   <td><code>@medium</code></td> 
   <td>测试超过 10s会被标记为失败</td> 
  </tr> 
  <tr> 
   <td><code>@small</code></td> 
   <td>测试超过 1s会被标记为失败</td> 
  </tr> 
  <tr> 
   <td><code>@test</code></td> 
   <td>标记某个非 <code>test</code> 开头的函数能够被当做测试函数进行测试</td> 
  </tr> 
  <tr> 
   <td><code>@dataProvider</code></td> 
   <td>指明提供参数的函数名称</td> 
  </tr> 
 </tbody> 
</table>

[https_phpunit.de_manual_6.5_en_writing-tests-for-phpunit.html]: https://phpunit.de/manual/6.5/en/writing-tests-for-phpunit.html