PHPUnit 命令行测试执行器可通过 phpunit 命令调用。下面的代码展示了如何用 PHPUnit 命令行测试执行器来运行测试：
phpunit ArrayTest
PHPUnit 4.2.0 by Sebastian Bergmann.
..
Time: 0 seconds
OK (2 tests, 2 assertions)
上面这个调用例子中，PHPUnit 命令行测试执行器将在当前工作目录中寻找 ArrayTest.php 源文件并加载之。而在此源文件中应当能找到 ArrayTest 测试用例类，此类中的测试将被执行。
对于每个测试的运行，PHPUnit 命令行工具输出一个字符来指示进展：
PHPUnit 区分 失败(failure) 与
错误(error)。失败指的是被违背了的 PHPUnit 断言，例如一个失败的 assertEquals() 调用。错误指的是意料之外的异常(exception)或 PHP 错误。有时候这种差别被证明是非常有用的，因为错误往往比失败更容易修复。如果得到了一个非常长的问题列表，那么最好先对付错误，当错误全部修复了之后再试一次瞧瞧还有没有失败。
让我们来瞧瞧以下代码中命令行测试运行器的各种选项：
phpunit --help
PHPUnit 4.2.0 by Sebastian Bergmann.
Usage: phpunit [options] UnitTest [UnitTest.php]
phpunit [options] <directory>
Code Coverage Options:
--coverage-clover <file> Generate code coverage report in Clover XML format.
--coverage-crap4j <file> Generate code coverage report in Crap4J XML format.
--coverage-html <dir> Generate code coverage report in HTML format.
--coverage-php <file> Export PHP_CodeCoverage object to file.
--coverage-text=<file> Generate code coverage report in text format.
Default: Standard output.
--coverage-xml <dir> Generate code coverage report in PHPUnit XML format.
Logging Options:
--log-junit <file> Log test execution in JUnit XML format to file.
--log-tap <file> Log test execution in TAP format to file.
--log-json <file> Log test execution in JSON format.
--testdox-html <file> Write agile documentation in HTML format to file.
--testdox-text <file> Write agile documentation in Text format to file.
Test Selection Options:
--filter <pattern> Filter which tests to run.
--testsuite <pattern> Filter which testsuite to run.
--group ... Only runs tests from the specified group(s).
--exclude-group ... Exclude tests from the specified group(s).
--list-groups List available test groups.
--test-suffix ... Only search for test in files with specified
suffix(es). Default: Test.php,.phpt
Test Execution Options:
--report-useless-tests Be strict about tests that do not test anything.
--strict-coverage Be strict about unintentionally covered code.
--disallow-test-output Be strict about output during tests.
--enforce-time-limit Enforce time limit based on test size.
--strict Run tests in strict mode (enables all of the above).
--process-isolation Run each test in a separate PHP process.
--no-globals-backup Do not backup and restore $GLOBALS for each test.
--static-backup Backup and restore static attributes for each test.
--colors Use colors in output.
--stderr Write to STDERR instead of STDOUT.
--stop-on-error Stop execution upon first error.
--stop-on-failure Stop execution upon first error or failure.
--stop-on-risky Stop execution upon first risky test.
--stop-on-skipped Stop execution upon first skipped test.
--stop-on-incomplete Stop execution upon first incomplete test.
-v|--verbose Output more verbose information.
--debug Display debugging information during test execution.
--loader <loader> TestSuiteLoader implementation to use.
--repeat <times> Runs the test(s) repeatedly.
--tap Report test execution progress in TAP format.
--testdox Report test execution progress in TestDox format.
--printer <printer> TestSuiteListener implementation to use.
Configuration Options:
--bootstrap <file> A "bootstrap" PHP file that is run before the tests.
-c|--configuration <file> Read configuration from XML file.
--no-configuration Ignore default configuration file (phpunit.xml).
--include-path <path(s)> Prepend PHP's include_path with given path(s).
-d key[=value] Sets a php.ini value.
Miscellaneous Options:
-h|--help Prints this usage information.
--version Prints the version and exits.phpunit UnitTest
运行由 UnitTest 类提供的测试。这个类应当在 UnitTest.php 源文件中声明。
UnitTest 这个类必须满足以下二个条件之一：要么它继承自 PHPUnit_Framework_TestCase；要么它提供 public static suite() 方法，这个方法返回一个 PHPUnit_Framework_Test 对象，比如，一个 PHPUnit_Framework_TestSuite 类的实例。
phpunit UnitTest UnitTest.php
运行由 UnitTest 类提供的测试。这个类应当在指定的源文件中声明。
--coverage-clover为运行的测试生成带有代码覆盖率信息的 XML 格式的日志文件。更多细节请参见第 14 章。
请注意，此功能仅当安装了 tokenizer 和 Xdebug 这两个 PHP 扩展后才可用。
--coverage-crap4j生成 Crap4j 格式的代码覆盖率报告。更多细节请参见第 11 章。
请注意，此功能仅当安装了 tokenizer 和 Xdebug 这两个 PHP 扩展后才可用。
--coverage-html生成 HTML 格式的代码覆盖率报告。更多细节请参见第 11 章。
请注意，此功能仅当安装了 tokenizer 和 Xdebug 这两个 PHP 扩展后才可用。
--coverage-php生成一个序列化后的 PHP_CodeCoverage 对象，此对象含有代码覆盖率信息。
请注意，此功能仅当安装了 tokenizer 和 Xdebug 这两个 PHP 扩展后才可用。
--coverage-text为运行的测试以人们可读的格式生成带有代码覆盖率信息的日志文件或命令行输出。更多细节请参见第 14 章。
请注意，此功能仅当安装了 tokenizer 和 Xdebug 这两个 PHP 扩展后才可用。
--log-junit为运行的测试生成 JUnit XML 格式的日志文件。更多细节请参见第 14 章。
--log-tap为运行的测试生成 Test Anything Protocol (TAP) 格式的日志文件。更多细节请参见第 14 章。
--log-json--testdox-html and --testdox-text为运行的测试以 HTML 或纯文本格式生成敏捷文档。更多细节请参见第 12 章。
--filter
只运行名称与给定模式匹配的测试。如果模式未闭合包裹于分隔符，PHPUnit 将用 / 分隔符对其进行闭合包裹。
测试名称将以以下格式之一进行匹配：
TestNamespace\TestCaseClass::testMethod
默认的测试名称格式等价于在测试方法内使用 __METHOD__ 魔术常量。
TestNamespace\TestCaseClass::testMethod with data set #0当测试拥有数据供给器时，数据的每轮迭代都会将其当前索引附加在默认测试名称结尾处。
TestNamespace\TestCaseClass::testMethod with data set "my named data"当测试拥有使用命名数据集的数据供给器时，数据的每轮迭代都会将当前名称附加在默认测试名称结尾处。命名数据集的例子参见例 3.1。
例 3.1: 命名数据集
<?php
namespace TestNamespace;
class TestCaseClass extends \PHPUnit_Framework_TestCase
{
/**
* @dataProvider provider
*/
public function testMethod($data)
{
$this->assertTrue($data);
}
public function provider()
{
return array(
'my named data' => array(true),
'my data' => array(true)
);
}
}
?>/path/to/my/test.phpt对于 PHPT 测试，其测试名称是文件系统路径。
有效的过滤器模式例子参见例 3.2。
例 3.2: 过滤器模式例子
--filter 'TestNamespace\\TestCaseClass::testMethod'
--filter 'TestNamespace\\TestCaseClass'
--filter TestNamespace
--filter TestCaseClass
--filter testMethod
--filter '/::testMethod .*"my named data"/'
--filter '/::testMethod .*#5$/'
--filter '/::testMethod .*#(5|6|7)$/'
在匹配数据供给器时有一些额外的快捷方式，参见例 3.3。
例 3.3: 过滤器的快捷方式
--filter 'testMethod#2'
--filter 'testMethod#2-4'
--filter '#2'
--filter '#2-4'
--filter 'testMethod@my named data'
--filter 'testMethod@my.*data'
--filter '@my named data'
--filter '@my.*data'
--testsuite只运行名称与给定模式匹配的测试套件。
--group
只运行来自指定分组（可以多个）的测试。可以用 @group 标注为测试标记其所属的分组。
@author 标注是 @group 的一个别名，允许按作者来筛选测试。
--exclude-group
排除来自指定分组（可以多个）的测试。可以用 @group 标注为测试标记其所属的分组。
--list-groups列出所有有效的测试分组。
--test-suffix只查找文件名以指定后缀（可以多个）结尾的测试文件。
--report-useless-tests对事实上不测试任何内容的测试更加严格。详情参见第 6 章。
--strict-coverage对意外的代码覆盖更加严格。详情参见第 6 章。
--disallow-test-output对测试执行期间产生的输出更加严格。详情参见第 6 章。
--enforce-time-limit根据测试规模对其加上执行时长限制。详情参见第 6 章。
--strict
以严格模式运行测试（效果的功能等同于使用 --report-useless-tests、
--strict-coverage、 --disallow-test-output、
和 --enforce-time-limit）。详情参见第 6 章。
--process-isolation每个测试都在独立的PHP进程中运行。
--no-globals-backup不要备份并还原 $GLOBALS。更多细节请参见“全局状态”一节。
--static-backup备份并还原用户定义的类中的静态属性。更多细节请参见“全局状态”一节。
--colors使用彩色输出。
--stderr
选择输出到 STDERR 而非 STDOUT。
--stop-on-error首次错误出现后停止执行。
--stop-on-failure首次错误或失败出现后停止执行。
--stop-on-risky首次碰到有风险的测试时停止执行。
--stop-on-skipped首次碰到跳过的测试时停止执行。
--stop-on-incomplete首次碰到不完整的测试时停止执行。
--verbose输出更详尽的信息，例如不完整或者跳过的测试的名称。
--debug输出调试信息，例如当一个测试开始执行时输出其名称。
--loader
指定要使用的 PHPUnit_Runner_TestSuiteLoader 实现。
标准的测试套件加载器将在当前工作目录和 PHP 的 include_path 配置指令中指定的每个目录内查找源文件。诸如 Project_Package_Class 这样的类名对应的源文件名为 Project/Package/Class.php。
--repeat将测试重复运行指定次数。
--tap使用 Test Anything Protocol (TAP) 报告测试进度。 更多细节请参见第 14 章。
--testdox将测试进度作为敏捷文档来报告。更多细节请参见第 12 章。
--printer
指定要使用的结果输出器(printer)。输出器类必须扩展 PHPUnit_Util_Printer 并且实现 PHPUnit_Framework_TestListener 接口。
--bootstrap在测试前先运行一个 "bootstrap" PHP 文件。
--configuration, -c从 XML 文件中读取配置信息。更多细节请参见附录 C。
如果当前工作目录下存在 phpunit.xml 或者 phpunit.xml.dist （按此顺序查找），同时又未使用 --configuration 选项，那么将自动从此文件中读取配置信息。
--no-configuration
忽略当前工作目录下的 phpunit.xml 与 phpunit.xml.dist。
--include-path
向 PHP 的 include_path 开头添加指定路径（可以多个）。
-d设置指定的 PHP 配置选项的值。
请注意，选项不能放在参数之后。