phpunit

教程及文档：

https://www.jianshu.com/p/abcca5aa3ad6

http://www.phpunit.cn/manual/current/zh_cn/phpunit-book.html#installation.requirements

https://phpunit.readthedocs.io/zh_CN/latest/

https://www.kancloud.cn/manual/phpunit-book/68615

http://phpunit.cn/manual/7.0/zh_cn/index.html

注意安装分为档案包phpunit.phar和composer安装

phpunit.phar ：将所有的类都压缩到这个档案包里了   

composer：    没有压缩默认会下载到项目的vendor目录里

写好测试类后需要在窗口命令行执行才行！

phpunit ArrayTest

例子中，PHPUnit 命令行测试执行器将在当前工作目录中寻找 ArrayTest.php 源文件并加载之。而在此源文件中应当能找到 ArrayTest 测试用例类，此类中的测试将被执行

phpunit.xml

在使用phpunit时将命令路径移动到测试文件目录，使用phpunit命令要不然会出现读取不了PHPUnit.xml

bootstrap="./autoload.php"     在测试之前加载的的PHP 文件，一般可以做一个初始化工作

name：                 套件名称

directory ：           套件测试的目录，目录下一般放测试文件的用例

----suffix :          测试文件后缀，如果不填写，则默认后缀为*Test.php,即phpunit 默认会执行*Test.php  的文件

----action:         测试目录名

file：                    可以单独设置测试文件

exclude：            排除不需要测试的文件

可以用 phpVersion 和 phpVersionOperator 属性来指定 PHP 版本需求。在以下例子中，仅当 PHP 版本至少为 5.3.0 时才会将 /path/to/*Test.php 文件与 /path/to/MyTest.php 文件添加到测试套件中

<file phpVersion="5.3.0" phpVersionOperator=">=">/path/to/MyTest.php</file>

 <php>
  <includePath>.</includePath>
  <ini name="foo" value="bar"/>
  <const name="foo" value="bar"/>
  <var name="foo" value="bar"/>
  <env name="foo" value="bar"/>
  <post name="foo" value="bar"/>
  <get name="foo" value="bar"/>
  <cookie name="foo" value="bar"/>
  <server name="foo" value="bar"/>
  <files name="foo" value="bar"/>
  <request name="foo" value="bar"/>
</php>  

这段xml 可以对应以下PHP 代码

includePath

ini_set('foo', 'bar');
define('foo', 'bar');
$GLOBALS['foo'] = 'bar';
$_ENV['foo'] = 'bar';
$_POST['foo'] = 'bar';
$_GET['foo'] = 'bar';
$_COOKIE['foo'] = 'bar';
$_SERVER['foo'] = 'bar';
$_FILES['foo'] = 'bar';
$_REQUEST['foo'] = 'bar';

目录结构

├── reports

├── phpunit.xml
├── src
│   ├── autoload.php
│   ├── Money.php
└── tests
    └── MoneyTest.php

1、定义

D:\xampp\htdocs\test\PHPunit>phpunit --bootstrap ./src/Money.php ./tests/MoneyTest.php

手动指定autoload.php       D:\xampp\htdocs\test\PHPunit>phpunit --bootstrap ./src/autoload.php ./tests/MoneyTest

定义xml文件后     D:\xampp\htdocs\test\PHPunit>phpunit ./tests/MoneyTest

<?xml version="1.0" encoding="UTF-8"?>
<!-- 它将在递归遍历添加在tests的所有 *Test.php 文件中找到的 *Test 类 -->
<phpunit bootstrap="./src/autoload.php" verbose="true">
    <testsuites>
        <testsuite name="money test">
            <directory suffix="Test.php">tests</directory>
        </testsuite>
    </testsuites>
    <filter>
        <whitelist processUncoveredFilesFromWhitelist="true">
            <directory suffix=".php">./src</directory>
        </whitelist>
    </filter>
</phpunit>

日志

利用PHP CodeCoverage來计算程序代码覆盖率(code coverage)，需要安裝 Xdebug

https://pecl.php.net/package/xdebug 下载 然后将dll扩展放到php/ext  ，php.ini extendsion=xxxx...

先在项目下建立一个reports/目录，存放code coverage分析的结果。

然后执行

phpunit --coverage-html reports/ tests/
D:\xampp\htdocs\test\PHPunit>phpunit --coverage-html ./reports/ ./tests/

或者执行

phpunit --bootstrap vendor/autoload.php --coverage-html reports/ tests/

当然,也可以使用XML来设定。

    <logging>
        <log type="coverage-html" target="./reports" charset="UTF-8"/>
    </logging>

接着执行测试:

phpunit tests/EventTest.php

断言：

assertArrayHasKey()
assertClassHasAttribute()
assertArraySubset()
assertClassHasStaticAttribute()
assertContains()
assertContainsOnly()
assertContainsOnlyInstancesOf()
assertCount()
assertEmpty()
assertEqualXMLStructure()
assertEquals()
assertFalse()
assertFileEquals()
assertFileExists()
assertGreaterThan()
assertGreaterThanOrEqual()
assertInfinite()
assertInstanceOf()
assertInternalType()
assertJsonFileEqualsJsonFile()
assertJsonStringEqualsJsonFile()
assertJsonStringEqualsJsonString()
assertLessThan()
assertLessThanOrEqual()
assertNan()
assertNull()
assertObjectHasAttribute()
assertRegExp()
assertStringMatchesFormat()
assertStringMatchesFormatFile()
assertSame()
assertStringEndsWith()
assertStringEqualsFile()
assertStringStartsWith()
assertThat()
assertTrue()
assertXmlFileEqualsXmlFile()
assertXmlStringEqualsXmlFile()
assertXmlStringEqualsXmlString()

标注：
@author
@after
@afterClass
@backupGlobals
@backupStaticAttributes
@before
@beforeClass
@codeCoverageIgnore*
@covers
@coversDefaultClass
@coversNothing
@dataProvider
@depends 测试类中一个方法依赖另一个方法的标注
@expectedException
@expectedExceptionCode
@expectedExceptionMessage
@expectedExceptionMessageRegExp
@group
@large
@medium
@preserveGlobalState
@requires
@runTestsInSeparateProcesses
@runInSeparateProcess
@small
@test
@testdox
@ticket
@uses