PHPUnit Manual

Edition for PHPUnit latest. Updated on 2020 年 02 月 07 日.

Sebastian Bergmann

This work is licensed under the Creative Commons Attribution 3.0 Unported License.

Contents:

• 1. 安装 PHPUnit
  • PHP 档案包 (PHAR)
    • Windows
    • 校验 PHPUnit PHAR 发行包
  • Composer
  • 可选的组件包
• 2. 编写 PHPUnit 测试
  • 测试的依赖关系
  • 数据供给器
  • 对异常进行测试
  • 对 PHP 错误进行测试
  • 对输出进行测试
  • 错误相关信息的输出
    • 边缘情况
• 3. 命令行测试执行器
  • 命令行选项
• 4. 基境(fixture)
  • setUp() 多 tearDown() 少
  • 基境共享
  • 全局状态
• 5. 组织测试
  • 用文件系统来编排测试套件
  • 用 XML 配置来编排测试套件
• 6. 有风险的测试
  • 无用测试
  • 意外的代码覆盖
  • 测试执行期间产生的输出
  • 测试执行时长的超时限制
  • 全局状态篡改
• 7. 未完成的测试与跳过的测试
  • 未完成的测试
  • 跳过测试
  • 用 @requires 来跳过测试
• 8. 数据库测试
  • 数据库测试所支持的供应商
  • 数据库测试的难点
  • 数据库测试的四个阶段
    • 1. 清理数据库
    • 2. 建立基境
    • 3–5. 运行测试、验证结果、并拆除基境
  • PHPUnit 数据库测试用例的配置
    • 实现 getConnection()
    • 实现 getDataSet()
    • 数据库构架(DDL)怎么办？
    • 小建议：使用你自己的抽象数据库 TestCase 类
  • 理解 DataSet（数据集）和 DataTable（数据表）
    • 可用的各种实现
    • 当心外键
    • 实现自有的 DataSet/DataTable
  • 数据库连接 API
  • 数据库断言 API
    • 对表中数据行的数量作出断言
    • 对表的状态作出断言
    • 对查询的结果作出断言
    • 对多个表的状态作出断言
  • 常见问题（FAQ）
    • PHPUnit 会为每个测试（重新）创建数据库吗？
    • 为了让数据库扩展模块正常工作，需要在应用程序中使用 PDO 吗？
    • 如果看到 “Too much Connections“ 错误该怎么办？
    • Flat XML / CSV 数据集中如何处理 NULL？
• 9. 测试替身
  • Stubs （桩件）
  • 仿件对象(Mock Object)
  • Prophecy
  • 对特质(Trait)与抽象类进行模仿
  • 对 Web 服务(Web Services)进行上桩或模仿
  • 对文件系统进行模仿
• 10. 测试实践
  • 在开发过程中
  • 在调试过程中
• 11. 代码覆盖率分析
  • 用于代码覆盖率的软件衡量标准
  • 将文件列入白名单
  • 略过代码块
  • 指明要覆盖的方法
  • 边缘情况
• 12. 测试的其他用途
  • 敏捷文档
  • 跨团队测试
• 13. Logging （日志记录）
  • 测试结果 (XML)
  • 代码覆盖率 (XML)
  • 代码覆盖率 (TEXT)
• 14. 扩展 PHPUnit
  • PHPUnit\Framework\TestCase 的子类
  • 编写自定义断言
  • 实现 PHPUnit\Framework\TestListener
  • 实现 PHPUnit_Framework_Test

Appendix

• 1. 断言方法的用法：静态 vs. 非静态
• 2. assertArrayHasKey()
• 3. assertClassHasAttribute()
• 4. assertArraySubset()
• 5. assertClassHasStaticAttribute()
• 6. assertContains()
• 7. assertContainsOnly()
• 8. assertContainsOnlyInstancesOf()
• 9. assertCount()
• 10. assertDirectoryExists()
• 11. assertDirectoryIsReadable()
• 12. assertDirectoryIsWritable()
• 13. assertEmpty()
• 14. assertEqualXMLStructure()
• 15. assertEquals()
• 16. assertFalse()
• 17. assertFileEquals()
• 18. assertFileExists()
• 19. assertFileIsReadable()
• 20. assertFileIsWritable()
• 21. assertGreaterThan()
• 22. assertGreaterThanOrEqual()
• 23. assertInfinite()
• 24. assertInstanceOf()
• 25. assertInternalType()
• 26. assertIsReadable()
• 27. assertIsWritable()
• 28. assertJsonFileEqualsJsonFile()
• 29. assertJsonStringEqualsJsonFile()
• 30. assertJsonStringEqualsJsonString()
• 31. assertLessThan()
• 32. assertLessThanOrEqual()
• 33. assertNan()
• 34. assertNull()
• 35. assertObjectHasAttribute()
• 36. assertRegExp()
• 37. assertStringMatchesFormat()
• 38. assertStringMatchesFormatFile()
• 39. assertSame()
• 40. assertStringEndsWith()
• 41. assertStringEqualsFile()
• 42. assertStringStartsWith()
• 43. assertThat()
• 44. assertTrue()
• 45. assertXmlFileEqualsXmlFile()
• 46. assertXmlStringEqualsXmlFile()
• 47. assertXmlStringEqualsXmlString()
• 48. @author
• 49. @after
• 50. @afterClass
• 51. @backupGlobals
• 52. @backupStaticAttributes
• 53. @before
• 54. @beforeClass
• 55. @codeCoverageIgnore*
• 56. @covers
• 57. @coversDefaultClass
• 58. @coversNothing
• 59. @dataProvider
• 60. @depends
• 61. @expectedException
• 62. @expectedExceptionCode
• 63. @expectedExceptionMessage
• 64. @expectedExceptionMessageRegExp
• 65. @group
• 66. @large
• 67. @medium
• 68. @preserveGlobalState
• 69. @requires
• 70. @runTestsInSeparateProcesses
• 71. @runInSeparateProcess
• 72. @small
• 73. @test
• 74. @testdox
• 75. @ticket
• 76. @uses
• 77. XML 配置文件
  • PHPUnit
  • 测试套件
  • Whitelisting Files for Code Coverage
  • Logging （日志记录）
  • 测试监听器
  • 设定 PHP INI 设置、常量、全局变量
• 78. 参考书目