我使用bin/cake bake plugin PluginName
来创建插件。部分原因是它创建了phpunit.xml.dist
,但是烘焙不会创建所需的文件夹结构或tests/bootstrap.php
文件。
问题
当我运行phpunit
时,我收到“未执行测试”消息:
$ phpunit
PHPUnit 5.1.3 by Sebastian Bergmann and contributors.
Time: 239 ms, Memory: 4.50Mb
No tests executed!
背景资料
我在tests/TestCase
下的插件文件夹中创建了测试。我不认为它们是问题,但我会在最后发布它们。
我正在使用默认的phpunit.xml.dist
文件,我将其用于tests/bootstrap.php
:
$findRoot = function ($root) {
do {
$lastRoot = $root;
$root = dirname($root);
if (is_dir($root . '/vendor/cakephp/cakephp')) {
return $root;
}
} while ($root !== $lastRoot);
throw new Exception("Cannot find the root of the application, unable to run tests");
};
$root = $findRoot(__FILE__);
unset($findRoot);
chdir($root);
define('ROOT', $root);
define('APP_DIR', 'App');
define('WEBROOT_DIR', 'webroot');
define('APP', ROOT . '/tests/App/');
define('CONFIG', ROOT . '/tests/config/');
define('WWW_ROOT', ROOT . DS . WEBROOT_DIR . DS);
define('TESTS', ROOT . DS . 'tests' . DS);
define('TMP', ROOT . DS . 'tmp' . DS);
define('LOGS', TMP . 'logs' . DS);
define('CACHE', TMP . 'cache' . DS);
define('CAKE_CORE_INCLUDE_PATH', ROOT . '/vendor/cakephp/cakephp');
define('CORE_PATH', CAKE_CORE_INCLUDE_PATH . DS);
define('CAKE', CORE_PATH . 'src' . DS);
require ROOT . '/vendor/autoload.php';
require CORE_PATH . 'config/bootstrap.php';
单元测试
这位于tests/TestCase/Color.php
<?php
namespace Contrast\TestCase;
use Cake\TestSuite\TestCase;
use Contrast\Text\Color;
/**
* Contrast Text Color tests
*/
class TextColorTest extends TestCase
{
/**
* @test
* @return void
*/
public function testShouldHandleVarietyOfColors()
{
# Returns black
$this->assertEquals(Color::getBlackWhiteContrast('#FFFFFF'), 'black');
// Why won't you fail??
$this->assertEquals(true, false);
}
答案 0 :(得分:7)
基本命名空间应该是Contrast\Test
,这也是应该在您的应用composer.json
个文件autoload
和autoload-dev
部分添加bake以及烘焙的内容plugins composer.json
文件。如果您拒绝烘焙以编辑yout composer.json
文件,则应手动添加自动加载条目
"autoload": {
"psr-4": {
// ...
"Contrast\\": "./plugins/Contrast/src"
}
},
"autoload-dev": {
"psr-4": {
// ...
"Contrast\\Test\\": "./plugins/Contrast/tests"
}
},
并重新转储自动加载器
$ composer dump-autoload
因此,示例测试的命名空间应为Contrast\Test\TestCase
。
此外,测试文件需要加Test
后缀,以便PHPUnit识别它们。并且为了使文件可以自动加载,您应该坚持使用PSR-4,即文件应该与类名相同,即您的测试文件应该命名为TextColorTest.php
,而不是Color.php
。
在将插件作为应用程序的一部分进行测试时,插件测试中不一定需要一个bootstrap文件(虽然bake应该会生成一个),因为您可以使用应用程序的配置运行它们,它有一个测试引导程序文件(tests/bootstrap.php
),其中包含您的应用程序引导程序文件(config/bootstrap.php
)。
因此,测试将从您的应用程序基础文件夹运行,并且您必须通过插件路径,例如
$ vendor/bin/phpunit plugins/Contrast
或者您在应用主phpunit配置文件中添加了一个额外的插件测试套件,其中显示<!-- Add your plugin suites -->
<testsuite name="Contrast Test Suite">
<directory>./plugins/Contrast/tests/TestCase</directory>
</testsuite>
这样,插件测试将与您的应用测试一起运行。
最后,您还可以从插件目录运行测试,因为存在正确的引导程序文件。目前的默认值如下:
<?php
/**
* Test suite bootstrap for Contrast.
*
* This function is used to find the location of CakePHP whether CakePHP
* has been installed as a dependency of the plugin, or the plugin is itself
* installed as a dependency of an application.
*/
$findRoot = function ($root) {
do {
$lastRoot = $root;
$root = dirname($root);
if (is_dir($root . '/vendor/cakephp/cakephp')) {
return $root;
}
} while ($root !== $lastRoot);
throw new Exception("Cannot find the root of the application, unable to run tests");
};
$root = $findRoot(__FILE__);
unset($findRoot);
chdir($root);
require $root . '/config/bootstrap.php';
另见
以独立方式开发插件时,这就是您真正需要一个设置环境的引导文件,而这正是使用bake生成的插件composer.json
文件的地方。默认情况下,后者看起来像
{
"name": "your-name-here/Contrast",
"description": "Contrast plugin for CakePHP",
"type": "cakephp-plugin",
"require": {
"php": ">=5.4.16",
"cakephp/cakephp": "~3.0"
},
"require-dev": {
"phpunit/phpunit": "*"
},
"autoload": {
"psr-4": {
"Contrast\\": "src"
}
},
"autoload-dev": {
"psr-4": {
"Contrast\\Test\\": "tests",
"Cake\\Test\\": "./vendor/cakephp/cakephp/tests"
}
}
}
烘焙插件时生成的测试引导文件并不是开箱即用的,因为它只会尝试加载插件的config/bootstrap.php
文件,默认情况下不会这样做。甚至存在。
测试引导程序文件需要做什么取决于插件当然在做什么,但至少它应该
出于示例目的,这里有一个tests/bootstrap.php
示例,其中包含当前cakephp/app
应用程序模板的副本,即它基本上配置了一个完整的应用程序环境(定义了应用程序的应用程序)在tests/TestApp
文件夹中):
// from `config/paths.php`
if (!defined('DS')) {
define('DS', DIRECTORY_SEPARATOR);
}
define('ROOT', dirname(__DIR__));
define('APP_DIR', 'test_app');
define('APP', ROOT . DS . 'tests' . DS . APP_DIR . DS);
define('CONFIG', ROOT . DS . 'config' . DS);
define('WWW_ROOT', APP . 'webroot' . DS);
define('TESTS', ROOT . DS . 'tests' . DS);
define('TMP', ROOT . DS . 'tmp' . DS);
define('LOGS', TMP . 'logs' . DS);
define('CACHE', TMP . 'cache' . DS);
define('CAKE_CORE_INCLUDE_PATH', ROOT . DS . 'vendor' . DS . 'cakephp' . DS . 'cakephp');
define('CORE_PATH', CAKE_CORE_INCLUDE_PATH . DS);
define('CAKE', CORE_PATH . 'src' . DS);
// from `config/app.default.php` and `config/bootstrap.php`
use Cake\Cache\Cache;
use Cake\Console\ConsoleErrorHandler;
use Cake\Core\App;
use Cake\Core\Configure;
use Cake\Core\Configure\Engine\PhpConfig;
use Cake\Core\Plugin;
use Cake\Database\Type;
use Cake\Datasource\ConnectionManager;
use Cake\Error\ErrorHandler;
use Cake\Log\Log;
use Cake\Mailer\Email;
use Cake\Network\Request;
use Cake\Routing\DispatcherFactory;
use Cake\Utility\Inflector;
use Cake\Utility\Security;
require ROOT . DS . 'vendor' . DS . 'autoload.php';
require CORE_PATH . 'config' . DS . 'bootstrap.php';
$config = [
'debug' => true,
'App' => [
'namespace' => 'App',
'encoding' => env('APP_ENCODING', 'UTF-8'),
'defaultLocale' => env('APP_DEFAULT_LOCALE', 'en_US'),
'base' => false,
'dir' => 'src',
'webroot' => 'webroot',
'wwwRoot' => WWW_ROOT,
'fullBaseUrl' => false,
'imageBaseUrl' => 'img/',
'cssBaseUrl' => 'css/',
'jsBaseUrl' => 'js/',
'paths' => [
'plugins' => [ROOT . DS . 'plugins' . DS],
'templates' => [APP . 'Template' . DS],
'locales' => [APP . 'Locale' . DS],
],
],
'Asset' => [
// 'timestamp' => true,
],
'Security' => [
'salt' => env('SECURITY_SALT', '__SALT__'),
],
'Cache' => [
'default' => [
'className' => 'File',
'path' => CACHE,
'url' => env('CACHE_DEFAULT_URL', null),
],
'_cake_core_' => [
'className' => 'File',
'prefix' => 'myapp_cake_core_',
'path' => CACHE . 'persistent/',
'serialize' => true,
'duration' => '+2 minutes',
'url' => env('CACHE_CAKECORE_URL', null),
],
'_cake_model_' => [
'className' => 'File',
'prefix' => 'myapp_cake_model_',
'path' => CACHE . 'models/',
'serialize' => true,
'duration' => '+2 minutes',
'url' => env('CACHE_CAKEMODEL_URL', null),
],
],
'Error' => [
'errorLevel' => E_ALL & ~E_DEPRECATED,
'exceptionRenderer' => 'Cake\Error\ExceptionRenderer',
'skipLog' => [],
'log' => true,
'trace' => true,
],
'EmailTransport' => [
'default' => [
'className' => 'Mail',
// The following keys are used in SMTP transports
'host' => 'localhost',
'port' => 25,
'timeout' => 30,
'username' => 'user',
'password' => 'secret',
'client' => null,
'tls' => null,
'url' => env('EMAIL_TRANSPORT_DEFAULT_URL', null),
],
],
'Email' => [
'default' => [
'transport' => 'default',
'from' => 'you@localhost',
//'charset' => 'utf-8',
//'headerCharset' => 'utf-8',
],
],
'Datasources' => [
'test' => [
'className' => 'Cake\Database\Connection',
'driver' => 'Cake\Database\Driver\Mysql',
'persistent' => false,
'host' => 'localhost',
//'port' => 'non_standard_port_number',
'username' => 'my_app',
'password' => 'secret',
'database' => 'test_myapp',
'encoding' => 'utf8',
'timezone' => 'UTC',
'cacheMetadata' => true,
'quoteIdentifiers' => false,
'log' => false,
//'init' => ['SET GLOBAL innodb_stats_on_metadata = 0'],
'url' => env('DATABASE_TEST_URL', null),
],
],
'Log' => [
'debug' => [
'className' => 'Cake\Log\Engine\FileLog',
'path' => LOGS,
'file' => 'debug',
'levels' => ['notice', 'info', 'debug'],
'url' => env('LOG_DEBUG_URL', null),
],
'error' => [
'className' => 'Cake\Log\Engine\FileLog',
'path' => LOGS,
'file' => 'error',
'levels' => ['warning', 'error', 'critical', 'alert', 'emergency'],
'url' => env('LOG_ERROR_URL', null),
],
],
'Session' => [
'defaults' => 'php',
],
];
Configure::write($config);
date_default_timezone_set('UTC');
mb_internal_encoding(Configure::read('App.encoding'));
ini_set('intl.default_locale', Configure::read('App.defaultLocale'));
Cache::config(Configure::consume('Cache'));
ConnectionManager::config(Configure::consume('Datasources'));
Email::configTransport(Configure::consume('EmailTransport'));
Email::config(Configure::consume('Email'));
Log::config(Configure::consume('Log'));
Security::salt(Configure::consume('Security.salt'));
DispatcherFactory::add('Asset');
DispatcherFactory::add('Routing');
DispatcherFactory::add('ControllerFactory');
Type::build('time')
->useImmutable()
->useLocaleParser();
Type::build('date')
->useImmutable()
->useLocaleParser();
Type::build('datetime')
->useImmutable()
->useLocaleParser();
// finally load/register the plugin using a custom path
Plugin::load('Contrast', ['path' => ROOT]);
为了从测试应用程序文件夹中自动加载类,您必须在composer.json
文件中添加相应的自动加载条目(并再次重新转储自动加载器),如:
"autoload-dev": {
"psr-4": {
"Contrast\\Test\\": "tests",
"Contrast\\TestApp\\": "tests/test_app/src", // < here we go
"Cake\\Test\\": "./vendor/cakephp/cakephp/tests"
}
}
现在,使用bake创建插件,配置环境并安装CakePHP和PHPUnit依赖项,您应该能够像使用应用程序一样运行测试,即
$ vendor/bin/phpunit