PHPUnit学习笔记(五)PHPUnit参数详解

àì夳堔傛蜴生んèń 2022-05-16 01:22 206阅读 0赞

**PHPUnit参数详解:**

本文直接翻译自PHPUnit官方文档,个人翻译水平有限,可能会存在某些词和意思翻译不准的地方,进请谅解!  
  
    Runs the tests that are provided by the class UnitTest. This class is expected to be declared in the UnitTest.php sourcefile.

UnitTest must be either a class that inherits from PHPUnit\_Framework\_TestCase or a class that provides a public static suite() method which returns an PHPUnit\_Framework\_Test object, for example an instance of the PHPUnit\_Framework\_TestSuite class.  
    运行类UnitTest提供的所有测试，这个类需要定义在UnitTest.php这个文件中.  
    类UnitTest需要从PHPUnit\_Framework\_TestCase继承或者提供一个公开的静态方法suite()返回一个PHPUnit\_Framework\_Test对象的实例.  
      
phpunit UnitTest Test.php  
    Runs the tests that are provided by the class UnitTest. This class is expected to be declared in the specified sourcefile.  
    运行UnitTest提供的所有测试，这个类应该在定义在Test.php中  
      
**--log-junit**  
  
    Generates a logfile in JUnit XML format for the tests run.  
    生成JUnit XML格式的日志文件

**--log-tap**  
  
    Generates a logfile using the Test Anything Protocol (TAP) format for the tests run.   
    生成TAP格式的日志文件  
      
**--log-dbus**  
  
    Log test execution using DBUS.  
    使用DBUS记录测试的执行情况

**--log-json**  
  
    Generates a logfile using the JSON format.  
    生成JSON格式的日志文件  
      
**--coverage-html**  
  
    Generates a code coverage report in HTML format.   
    生成html格式的代码覆盖报告

Please note that this functionality is only available when the tokenizer and Xdebug extensions are installed.  
    请注意这个功能只能在tokenizer和Xdebug安装后才能使用

**--coverage-clover**  
  
    Generates a logfile in XML format with the code coverage information for the tests run.   
    生成xml格式的代码覆盖报告

Please note that this functionality is only available when the tokenizer and Xdebug extensions are installed.  
    请注意这个功能只能在tokenizer和Xdebug安装后才能使用

**--testdox-html and --testdox-text**  
  
    Generates agile documentation in HTML or plain text format for the tests that are run.   
    生成记录已运行测试的html或者纯文本格式的文件文档

**--filter**  
  
    Only runs tests whose name matches the given pattern. The pattern can be either the name of a single test or a regular expression that matches multiple test names.

只运行名字符合参数规定的格式的测试，参数可以是一个测试的名字或者一个匹配多个测试名字的正则表达式

**--group**  
  
    Only runs tests from the specified group(s). A test can be tagged as belonging to a group using the @group annotation.  
    只运行规定的测试组，一个测试可以使用@group注释来分组  
    The @author annotation is an alias for @group allowing to filter tests based on their authors.  
    @author注视是一个和@group关联的注释标签，用来根据作者来过滤测试

**--exclude-group**  
  
    Exclude tests from the specified group(s). A test can be tagged as belonging to a group using the @group annotation.  
    只包含规定的多个测试组，一个测试可以使用@group注释来分组

**--list-groups**  
  
    List available test groups.  
    列出可用的测试组  
      
**--loader**  
  
    Specifies the PHPUnit\_Runner\_TestSuiteLoader implementation to use.  
    定义使用PHPUnit\_Runner\_TestSuiteLoader的接口

The standard test suite loader will look for the sourcefile in the current working directory and in each directory that is specified in PHP's include\_path configuration directive. Following the PEAR Naming Conventions, a class name such as Project\_Package\_Class is mapped to the sourcefile name Project/Package/Class.php.  
    标准的standard test suite loader会在当前的目录和php的include\_path中根据PEAR的命名规则的类，一个叫做Project\_Package\_Class的类 会指向到文件Project/Package/Class.php  
      
**--repeat**  
  
    Repeatedly runs the test(s) the specified number of times.  
    根据定义的数字重复运行测试  
      
**--tap**  
  
    Reports the test progress using the Test Anything Protocol (TAP).  
    使用Test Anything Protocol格式报告测试进程  
      
**--testdox**  
  
    Reports the test progress as agile documentation.  
    使用agile documentation格式报告测试进程

**--colors**  
  
    Use colors in output.  
    在输出结果中使用颜色

**--stderr**  
  
    Optionally print to STDERR instead of STDOUT.  
    使用STDERR替代STDOUT输出结果

**--stop-on-error**  
  
    Stop execution upon first error.  
    在遇到第一个错误时停止执行  
      
**--stop-on-failure**  
  
    Stop execution upon first error or failure.  
    在遇到第一个失败时停止执行  
      
**--stop-on-skipped**  
  
    Stop execution upon first skipped test.  
    在遇到第一个跳过的测试时停止执行

**--stop-on-incomplete**  
  
    Stop execution upon first incomplete test.  
    在遇到第一个未完成的测试时停止执行

**--strict**  
  
    Mark a test as incomplete if no assertions are made.  
    当一个测试没有定义任何断言时将其标记为未完成的测试

**--verbose**  
  
    Output more verbose information, for instance the names of tests that were incomplete or have been skipped.  
    输出例如未完成的测试的名字，跳过的测试的名字

**--wait**  
  
    Waits for a keystroke after each test. This is useful if you are running the tests in a window that stays open only as long as the test runner is active.  
    在每个测试开始之前等待用户按键，这个在你一个保持打开的窗口中运行很长的测试时很有帮助

**--skeleton-class**  
  
    Generates a skeleton class Unit (in Unit.php) from a test case class UnitTest (in UnitTest.php).  
    从一个测试类中生成一个概要测试类  
      
**--skeleton-test**  
  
    Generates a skeleton test case class UnitTest (in UnitTest.php) for a class Unit (in Unit.php). See Chapter 17 for more details.  
    在Unit.php内为类Unit生成一个概要测试类UnitTest

**--process-isolation**  
  
    Run each test in a separate PHP process.  
    在多个php进程中运行所有测试

**--no-globals-backup**  
  
    Do not backup and restore $GLOBALS.  
    不备份和还原$GLOBALS变量

**--static-backup**  
  
    Backup and restore static attributes of user-defined classes.  
    备份和还原用户定义的类中的静态变量

**--syntax-check**  
  
    Enables the syntax check of test source files.  
    对测试的代码文件开启语法检查

**--bootstrap**  
  
    A "bootstrap" PHP file that is run before the tests.  
    定义测试前运行的bootstrap的php文件的路径

**--configuration, -c**  
  
    Read configuration from XML file. See Appendix C for more details.  
    从xml文件中读取配置，增加-c参数看更多的内容  
  
    If phpunit.xml or phpunit.xml.dist (in that order) exist in the current working directory and --configuration is not used, the configuration will be automatically read from that file.  
    如果phpunit.xml或phpunit.xml.dist(根据这个模式)在当前的目录中存在且--configuration参数没有使用的时候，配置信息会被自动读取

**--no-configuration**  
  
    Ignore phpunit.xml and phpunit.xml.dist from the current working directory.  
    自动跳过当前目录的phpunit.xml和phpunit.xml.dist配置文件

**--include-path**  
  
    Prepend PHP's include\_path with given path(s).  
    在php的include\_path增加路径

**-d**  
  
    Sets the value of the given PHP configuration option.  
    定义php的配置属性

**--debug**  
  
    Output debug information such as the name of a test when its execution starts.  
    输出调试信息如测试的名称及该测试什么时候开始执行  
      
Note  
提示  
When the tested code contains PHP syntax errors, the TextUI test runner might exit without printing error information.   
The standard test suite loader can optionally check the test suite sourcefile for PHP syntax errors, but not sourcefiles included by the test suite sourcefile.  
当测试代码中含有php语法错误的时候，测试器会退出且不会打印任何错误信息，standard test suite loader可选择性检查测试文件源代码的PHP语法错误，但是不会检查测试文件中引入的其他的代码文件的语法错误