PHP教程:PHPUnit学习笔记(五)PHPUnit参数详解

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语法错误，但是不会检查测试文件中引入的其他的代码文件的语法错误