avvertix/wptesttool

此包已被放弃,不再维护。未建议替代包。

创建用于您插件单元测试环境的Wordpress命令行接口。

v0.2.0 2016-12-06 08:49 UTC

This package is auto-updated.

Last update: 2022-04-08 17:38:35 UTC


README

Build Status

Wordpress 单元测试工具

本项目作为命令行,用于下载Wordpress单元测试辅助函数并设置执行插件单元测试的环境

此套件深受 WordPress REST API 插件 的启发,特别是 install-wp-test.sh 脚本。该脚本是一个很好的学习如何对WordPress插件进行单元测试的资源。

兼容Wordpress 4.4.2

是什么?

此工具集,也提供phar版本,可下载Wordpress版本、单元测试包含文件,并在测试执行配置过程中提供帮助。

使用方法

步骤 1

为了配置执行基于Wordpress的单元测试所需的依赖,请执行以下命令:

[php] ./bin/wptesttools.phar configure [--db=] [--user=] [--pass=] [--host=] [wp-version]

可用参数

参数 用途
wp-version 用于测试的Wordpress版本(例如,4.4.2)。如果没有指定,默认值为 latest,因此将使用最新版本

可用选项

选项 默认值 用途
db wptest 测试数据库名称
user wptest 测试数据库用户名
pass wptest 测试数据库密码
host localhost 测试数据库主机

步骤 2

现在您可以为运行单元测试时加载的 phpunit.xml 文件和引导程序创建一个存根。

要创建存根文件,请启动:

[php] ./bin/wptesttools.phar stub [--plugin=plugin.php] [test-folder]
参数 用途
test-folder 放置单元测试的文件夹。默认为 tests
选项 描述
plugin 您可以指定WordPress读取的文件来加载插件

引导程序将启用名为 PLUGIN_FILE 的环境变量,您可以使用该变量指定在WordPress中加载插件的主文件。

完整命令列表

downloadwp 命令

下载Wordpress版本并将其提取到 ./tmp/wordpress/

[php] ./bin/wptesttools.phar downloadwp [wp-version]
参数 用途
wp-version 用于测试的Wordpress版本(例如,4.4.2)。如果没有指定,默认值为 latest,因此将使用最新版本

installwp 命令

下载用于运行测试时的Wordpress单元测试包含文件和示例wp-config文件。使用的文件夹是 ./tmp/

[php] ./bin/wptesttools.phar installwp [wp-version]
参数 用途
wp-version 用于测试的Wordpress版本(例如,4.4.2)。如果没有指定,默认值为 latest,因此将使用最新版本

stub 命令

创建 phpunit.xmlboostrap.php 文件,这些文件定义了单元测试配置和运行测试的依赖项加载器。

[php] ./bin/wptesttools.phar stub [--plugin=plugin.php] [test-folder]
参数 用途
test-folder 放置单元测试的文件夹。默认为 tests
选项 描述
plugin 您可以指定WordPress读取的文件来加载插件
phpunit 您可以指定PHPUnit配置文件名称(默认 phpunit.xml

phpunit.xml 文件将在执行wptesttools二进制文件所在的当前目录中创建,而boostrap.php将在 test-folder 中创建。

多次调用 stub 命令将会覆盖现有文件