安装

1

＄创建symfony/phpunit-bridgob娱乐下载e

如果你打算PHPUnit桥接并且使用常规的PHPUnit脚本(不是Symfony提供的修改后的PHPUnit脚本)，您必须注册一个新的ob娱乐下载测试监听器被称为ob娱乐下载SymfonyTestsListener：

1 2 3 4 5 6 7 8 9 10 11

<！——http://phpunit.de/manual/6.0/en/appendixes.configuration.html——><phpunit)xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xsi: noNamespaceSchemaLocation＝“https://schema.phpunit.de/6.0/phpunit.xsd”><！——……--><听众><侦听器类＝“ob娱乐下载Symfony \ \ PhpUnit) \ SymfonyTestsListener桥”/>听众>phpunit)>

使用

一旦组件被安装，asimple-phpunit脚本在供应商/目录运行测试。这个脚本包装了原始的PHPUnit二进制文件，以提供更多的功能:

1 2

＄cd我的项目/＄/供应商/ bin / simple-phpunit

在运行你的PHPUnit测试之后，你会得到一个类似于下面的报告:

12 3 4 5 6 7 8 9 10 11 12 13 14 15

＄./vendor/bin/simple-phpunit配置读从<项目> / phpunit.xml。经销  .................时间:1.77秒，内存:5.75Mb OK(17个测试，21个断言)剩余的弃用通知(2)getEntityManager自Symfony 2.1以来已弃用。ob娱乐下载请使用getManager: 2x 1x在DefaultControllerTest:: testpublicurl from App\Tests\Controller 1x在BlogControllerTest::testIndex来自App\Tests\Controller

总结内容包括:

Unsilenced

报告在没有建议的情况下触发的弃用通知@-silencing运营商．

遗产

弃用通知表示显式测试某些遗留特性的测试。

剩余的/其他

弃用通知是所有其他(非遗留)通知，按消息、测试类和方法分组。

1 2 3 4 5

<！——phpunit.xml.dist——><！——……--><听众><侦听器类＝“ob娱乐下载Symfony \ \ PhpUnit) \ SymfonyTestsListener桥”/>听众>

并行运行测试

修改后的PHPUnit脚本允许通过提供包含多个测试套件的目录来并行运行测试phpunit.xml.dist．

1 2 3 4 5 6 7

├──tests/│├──Functional/││├──…││├──phpunt .xml.dist│├──Unit/││├──…││├─phpunt .xml.dist

1

＄/ /供应商/ bin / simple-phpunit测试

修改后的PHPUnit脚本将递归地遍历所提供的目录，最多可遍历3个子目录或环境变量指定的值ob娱乐下载SYMFONY_PHPUNIT_MAX_DEPTH，寻找phpunit.xml.dist文件，然后并行运行它找到的每个套件，收集它们的输出，并在各自的部分中显示每个测试套件的结果。

触发弃用通知

使用可以触发弃用通知trigger_deprecation从ob娱乐下载symfony / deprecation-contracts包:

1 2 3 4 5

//表示vendor-name/packagename的某些内容自版本1.3以来已弃用trigger_deprecation (“商家名称/包名称”，“1.3”，“您的弃用信息”）;//你也可以使用printf格式(消息后的所有参数都将被使用)trigger_deprecation (“……”，“1.3”，“值“%s”已弃用，使用…相反。”，＄价值）;

将测试标记为遗产

有三种方法将测试标记为遗留:

• （推荐)加上@group遗留类或方法的注释;
• 的类名开始遗产前缀;
• 使其方法名以testLegacy * ()而不是测试* ()．

配置

如果需要检查单元测试触发的特定弃用的堆栈跟踪，则可以设置ob娱乐下载SYMFONY_DEPRECATIONS_HELPER环境变量到与此弃用消息匹配的正则表达式，并用/．例如，使用:

12 3 4 5 6 7 8 9 10 11 12

<！——http://phpunit.de/manual/6.0/en/appendixes.configuration.html——><phpunit)xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xsi: noNamespaceSchemaLocation＝“https://schema.phpunit.de/6.0/phpunit.xsd”><！——……--><php><服务器的名字＝“KERNEL_CLASS”价值＝“应用程序\内核”/><env的名字＝“ob娱乐下载SYMFONY_DEPRECATIONS_HELPER”价值＝“foobar /”/>php>phpunit)>

PHPUnit)将停止您的测试套件一旦弃用通知被触发，其消息包含“foobar”字符串。

12 3 4 5 6 7 8 9 10 11 12

<！——phpunit.xml.dist——><！——……--><听众><侦听器类＝“ob娱乐下载Symfony \ \ PhpUnit) \ SymfonyTestsListener桥”><参数><数组><！——将此选项设置为0以禁用DebugClassLoader集成——><元素关键＝“debug-class-loader”><整数>0整数>元素>数组>参数>侦听器>听众>

1

＄PHP bin/console debug:container——deprecations

编写关于弃用的断言

在向代码中添加弃用项时，您可能喜欢编写测试来验证它们是否按要求被触发。为此，桥接提供expectDeprecation ()可以在测试方法上使用的方法。它要求您传递预期的消息，该消息以与PHPUnit)的assertStringMatchesFormat ()方法。如果你期望一个给定的测试方法有多个弃用消息，你可以多次使用该方法(顺序很重要):

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

使用PHPUnit)＼框架＼TestCase；使用ob娱乐下载＼桥＼PhpUnit)＼ExpectDeprecationTrait；类MyTest扩展TestCase｛使用ExpectDeprecationTrait；/ * * *@group遗留* /公共函数testDeprecatedCode（）｛//测试一些代码，触发以下弃用:// trigger_deprecation('vendor-name/package-name'， '5.1'， 'This "Foo" method is deprecated.');＄这->expectDeprecation (既然vendor-name/package-name 5.1:此“%s”方法已弃用）;/ /……//测试一些代码，触发以下弃用:// trigger_deprecation('vendor-name/package-name'， '4.4'， ' Bar方法的第二个参数已弃用');＄这->expectDeprecation (“由于vendor-name/package-name 4.4:“%s”方法的第二个参数已弃用。”）;}}

显示完整的堆栈跟踪

默认情况下，PHPUnit桥只显示弃用消息。若要显示与弃用相关的完整堆栈跟踪，请设置的值ob娱乐下载SYMFONY_DEPRECATIONS_HELPER到匹配弃用消息的正则表达式。

例如，如果抛出以下弃用通知:

1 2

1x: Doctrine\Common\ClassLoader已弃用。1 x在EntityTypeTest::安装从Symfony\ob娱乐下载桥\学说\测试\形式\类型

运行以下命令将显示完整的堆栈跟踪:

1

＄ob娱乐下载SYMFONY_DEPRECATIONS_HELPER ='/Doctrine\\Common\\ClassLoader已弃用\./'/供应商/ bin / simple-phpunit

使用多个PHPUnit版本进行测试

当测试一个必须与多个版本的PHP兼容的库时，测试套件不能使用最新版本的PHPUnit，因为:

• PHPUnit 8弃用了一些方法，取而代之的是旧版本中不可用的其他方法(例如PHPUnit 4);
• PHPUnit 8添加了无效返回类型到设置()方法，该方法与PHP 5.5不兼容;
• PHPUnit从PHPUnit 6开始切换到名称空间类，因此测试必须使用或不使用名称空间。

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

使用PHPUnit)＼框架＼TestCase；使用ob娱乐下载＼桥＼PhpUnit)＼SetUpTearDownTrait；类MyTest扩展TestCase｛//当使用SetUpTearDownTrait时，doSetUp()等方法可以//被定义为'void'返回类型，如你所愿使用SetUpTearDownTrait；私人函数doSetUp（）｛/ /……｝受保护的函数doSetUp（）：无效｛/ /……}}

对时间敏感的测试

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16

使用PHPUnit)＼框架＼TestCase；使用ob娱乐下载＼组件＼秒表＼秒表；类MyTest扩展TestCase｛公共函数testSomething（）｛＄秒表＝新秒表();＄秒表->开始(“event_name”）;睡眠(10）;＄持续时间＝＄秒表->停止(“event_name”）->getDuration ();＄这->assertequal (10000，＄持续时间）;}}

1 2 3 4 5

<！——phpunit.xml.dist——><！——……--><听众><侦听器类＝“\ob娱乐下载 Symfony \ \ PhpUnit) \ SymfonyTestsListener桥”/>听众>

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

使用PHPUnit)＼框架＼TestCase；使用ob娱乐下载＼组件＼秒表＼秒表；/ * * *@group对时间敏感的* /类MyTest扩展TestCase｛公共函数testSomething（）｛＄秒表＝新秒表();＄秒表->开始(“event_name”）;睡眠(10）;＄持续时间＝＄秒表->停止(“event_name”）->getDuration ();＄这->assertequal (10000，＄持续时间）;}}

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

//使用time()函数被模拟的类名称空间应用程序；类MyClass｛公共函数getTimeInHours（）｛返回时间()/3600；}}//显式模拟外部time()函数的测试名称空间应用程序＼测试；使用应用程序＼MyClass；使用PHPUnit)＼框架＼TestCase；使用ob娱乐下载＼桥＼PhpUnit)＼ClockMock；/ * * *@group对时间敏感的* /类MyTest扩展TestCase｛公共函数testGetTimeInHours（）{ClockMock：：注册(MyClass：：类);＄我的＝新MyClass ();＄结果＝＄我的->getTimeInHours ();＄这->assertequal() /(时间3600，＄结果）;}}

DNS-sensitive测试

建立网络连接的测试(例如检查DNS记录的有效性)可能由于网络条件而执行缓慢且不可靠。因此，该组件还提供了以下PHP函数的模拟:

• checkdnsrr
• dns_check_record
• getmxrr
• dns_get_mx
• gethostbyaddr
• gethostbyname
• gethostbynamel
• dns_get_record

12 3 4 5 6 7 8 9 10 11 12 13

使用应用程序＼验证器＼DomainValidator；使用PHPUnit)＼框架＼TestCase；类MyTest扩展TestCase｛公共函数testEmail（）｛＄验证器＝新DomainValidator ([“checkDnsRecord”= >真正的]);＄isValid＝＄验证器->validate (“example.com”）;/ /……}}

12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20 21

使用应用程序＼验证器＼DomainValidator；使用PHPUnit)＼框架＼TestCase；使用ob娱乐下载＼桥＼PhpUnit)＼DnsMock；/ * * *@groupdns-sensitive * /类DomainValidatorTest扩展TestCase｛公共函数testEmails（）{DnsMock：：withMockedHosts ([“example.com”= > [[“类型”= >“一个”，“知识产权”= >“为1.2.3.4”]]]);＄验证器＝新DomainValidator ([“checkDnsRecord”= >真正的]);＄isValid＝＄验证器->validate (“example.com”）;/ /……}}

12 3 4 5 6 7 8 9 10 11 12

DnsMock：：withMockedHosts ([“example.com”=> [[“类型”= >“一个”，“知识产权”= >“为1.2.3.4”，]， [“类型”= >“AAAA”，“ipv6”= >“::12”，]，]，]);

基于类存在性的测试

根据现有类表现不同的测试，例如Composer的开发依赖项，通常很难测试备用情况。因此，该组件还提供了以下PHP函数的模拟:

• class_exists
• interface_exists
• trait_exists

12 3 4 5 6 7 8 9 10 11 12 13

使用供应商＼DependencyClass；类MyClass｛公共函数你好（）：字符串｛如果(class_exists (DependencyClass：：类)){返回“依赖行为。”；｝返回“默认行为。”；}}

12 3 4 5 6 7 8 9 10 11 12 13

使用MyClass；使用PHPUnit)＼框架＼TestCase；类MyClassTest扩展TestCase｛公共函数testHello（）｛＄类＝新MyClass ();＄结果＝＄类->你好();// "依赖行为。"/ /……}}

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

使用MyClass；使用PHPUnit)＼框架＼TestCase；使用供应商＼DependencyClass；类MyClassTest扩展TestCase｛/ /……公共函数testHelloDefault（）{ClassExistsMock：：注册(MyClass：：类);ClassExistsMock：：withMockedClasses ([DependencyClass：：类= >假]);＄类＝新MyClass ();＄结果＝＄类->你好();// "默认行为。"/ /……}}

故障排除

的@group时效性而且@group dns-sensitive注释“按照约定”工作，并假设测试类的名称空间可以通过删除测试\部分来自test名称空间。例如，如果您的测试用例完全限定类名(FQCN)是应用\ \看\ DummyWatchTest测试，它假设测试的类名称空间为App \看．

如果此约定不适用于您的应用程序，请在phpunit.xml文件，例如在HttpKernel组件：

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

<！——http://phpunit.de/manual/4.1/en/appendixes.configuration.html——><phpunit)xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xsi: noNamespaceSchemaLocation＝“https://schema.phpunit.de/4.1/phpunit.xsd”><！——……--><听众><侦听器类＝“ob娱乐下载Symfony \ \ PhpUnit) \ SymfonyTestsListener桥”><参数><数组><元素关键＝“时效性”><字符串>ob娱乐下载Symfony \ \ HttpFoundation组件字符串>元素>数组>参数>侦听器>听众>phpunit)>

在底层，PHPUnit侦听器将模拟函数注入测试类的名称空间。为了按预期工作，侦听器必须在被测试的类运行之前运行。默认情况下，当找到注释并运行相应的测试时，将创建模拟函数。这取决于您的测试是如何构造的，可能为时已晚。在这种情况下，您需要在您的数据库中声明测试类的名称空间phpunit.xml.dist．

1 2 3 4 5 6 7 8 9 10 11

<！——phpunit.xml.dist——><！——……--><听众><侦听器类＝“ob娱乐下载Symfony \ \ PhpUnit) \ SymfonyTestsListener桥”><参数><数组><元素关键＝“时效性”><字符串>Acme \ MyClassTest字符串>元素>数组>参数>侦听器>听众>

修改PHPUnit脚本

这个桥提供了PHPUnit的修改版本，您可以使用它来调用bin / simple-phpunit命令。它具有以下特点:

• 使用独立的供应商目录，与您的目录不冲突;
• 不嵌入预言防止与其依赖项发生冲突;
• 控件时收集并重放跳过的测试ob娱乐下载SYMFONY_PHPUNIT_SKIPPED_TESTS定义了Env var: Env var应该指定一个文件名，该文件名将用于存储第一次运行时跳过的测试，并在第二次运行时重播它们;
• 当给定一个目录作为参数时，并行执行测试套件，扫描该目录phpunit.xml.dist档案最高可达ob娱乐下载SYMFONY_PHPUNIT_MAX_DEPTH级别(指定为env变量，默认为3.）;

脚本将它构建的修改后的PHPUnit写入一个目录，该目录可以由ob娱乐下载SYMFONY_PHPUNIT_DIREnv变量，或者在与simple-phpunit如果没有提供。中也可以设置这个env变量phpunit.xml.dist文件。

默认情况下，根据安装的PHP版本，这些是使用的PHPUnit版本:

如果你已经通过Composer安装了桥接器，你可以调用e.g.来运行它:

1

＄供应商/ bin / simple-phpunit

代码覆盖侦听器

默认情况下，使用以下规则计算代码覆盖率:如果执行了一行代码，则将其标记为覆盖。因此，执行一行代码的测试被标记为“覆盖一行代码”。这可能会产生误导。

考虑下面的例子:

12 34 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35

类酒吧｛公共函数barMethod（）｛返回“酒吧”；}}类喷火｛私人＄酒吧；公共函数__construct(酒吧＄酒吧）｛＄这->酒吧=＄酒吧；｝公共函数fooMethod（）｛＄这->酒吧->barMethod ();返回“酒吧”；}}类脚扩展PHPUnit)＼框架＼TestCase｛公共函数测验（）｛＄酒吧＝新酒吧();＄喷火＝新Foo (＄酒吧）;＄这->assertSame (“酒吧”，＄喷火->fooMethod ());}}

的脚:测试方法执行两者的每一行代码喷火而且酒吧类,但酒吧没有经过真正的测试。的CoverageListener旨在通过添加适当的@covers每个测试类上的注释。

类型的测试类@covers注释，这个侦听器什么也不做。方法来查找与测试相关的代码测试类名的一部分:我\名称空间\ \脚测试->我\名称空间\ Foo．

1 2 3 4 5 6 7 8 9 10 11

<！——http://phpunit.de/manual/6.0/en/appendixes.configuration.html——><phpunit)xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xsi: noNamespaceSchemaLocation＝“https://schema.phpunit.de/6.0/phpunit.xsd”><！——……--><听众><侦听器类＝“ob娱乐下载Symfony \ \ PhpUnit) \ CoverageListener桥”/>听众>phpunit)>

1 2 3 4 5 6 7

<听众><侦听器类＝“ob娱乐下载Symfony \ \ PhpUnit) \ CoverageListener桥”><参数><字符串>我的\ \ SutSolver:名称空间:解决字符串>参数>侦听器>听众>

1 2 3 4 5 6 7 8

<听众><侦听器类＝“ob娱乐下载Symfony \ \ PhpUnit) \ CoverageListener桥”><参数><零/><布尔>真正的布尔>参数>侦听器>听众>