PHPUnit安装教程

Gary

7 年前

使用PHPUnit的第一步就是安装PHPUnit。

1 准备条件

1.1 PHPUnit版本选择

最新版PHPUnit并不能在所有的PHP环境下使用。

例如，PHPUnit 6.4 不能在PHP 5.4 环境下使用，否则会出错。

对应版本支持如下：

PHPUnit 6.0~6.4：PHP7.0+
PHPUnit 5.0~5.7：PHP5.6+
PHPUnit 4.0~4.8：PHP 5.3.3+

（内容来源PHPUnit Release Announcements）

所以，在安装PHPUnit之前，要先确定测试环境的PHP版本，再根据PHP版本选择PHPUnit版本。

假设是PHP5.4就可以用PHPUnit 4的最后版本PHPUnit 4.8。

1.2 PHP扩展

PHPUnit必须扩展：dom、json、pcre、reflection、spl （这些默认已经开启，可以略过）

代码覆盖率需要扩展： Xdebug (2.5.0+) 、tokenizer

生成XML报告需要扩展：xmlwriter

2 composer方式安装（推荐）

在测试目录（一般是tests）下编写composer.json文件，内容：

{
    "require-dev": {
        "phpunit/phpunit": "~4.8.0",
        "phpunit/dbunit": "*",
        "codeception/aspect-mock": "*"
    }
}

这里我们一键安装了：

PHPUnit
用于数据测试的DBUnit组件
用于测试调用了静态类方法的AspectMock组件

不需要的可以删除对应行。

然后更新composer：

$ composer update

然后把bin目录添加到系统PATH环境变量中，例如我的是：

D:\works\tests\vendor\bin

打开终端执行监测：

$ phpunit --version
  PHPUnit x.y.z by Sebastian Bergmann and contributors.

说明安装完成。

3 Phar方式安装

安装 PHPUnit 另外一个简单的方法是下载 PHPUnit 的 PHP 档案包，

它将 PHPUnit 所需要的所有必要组件（包含PHP_Invoker，但不包含DbUnit）捆绑在单个文件中。

3.1 下载地址

各版本下载地址如下：

PHPUnit 6：https://phar.phpunit.de/phpunit-6.4.phar
PHPUnit 5：https://phar.phpunit.de/phpunit-5.7.phar
PHPUnit 4：https://phar.phpunit.de/phpunit-4.8.phar

其他中间版本修改版本号就可以下载了，

比如，要下载PHPUnit 6.0，下载地址的最后改成：phpunit-6.0.phar。

3.2 Linux

Linux系统安装 PHPUnit.phar 完整命令：

$ wget https://phar.phpunit.de/phpunit-6.2.phar
$ chmod +x phpunit-6.2.phar
$ sudo mv phpunit-6.2.phar /usr/local/bin/phpunit
$ phpunit --version
  PHPUnit x.y.z by Sebastian Bergmann and contributors.

3.3 Windows

在 Windows 下安装PHPUnit.phar 过程：

为 PHP 的二进制可执行文件建立一个目录，例如C:\bin
将;C:\bin附加到 PATH 环境变量中
下载PHPUnit Phar包，保存到C:\bin\phpunit.phar
在C:\bin目录下新建一个名为phpunit.cmd的文件（可由TXT文件改名），内容：
```
@php "%~dp0phpunit.phar" %*
```

新开一个命令行窗口，确认一下可以在任意路径下执行 PHPUnit：

C:\Users\username> phpunit --version
PHPUnit x.y.z by Sebastian Bergmann and contributors.

这样便安装完了PHPUnit。