Единые тесты

Написание корректных тестов может помочь в написании лучшего программного обеспечения. Если вы создадите правильные тестовые случаи, вы сможете устранить большинство функциональных ошибок и улучшить поддержку вашего программного обеспечения.

Интеграция PHPunit с Phalcon

Если у вас еще нет установленного phpunit, вы можете установить его с помощью следующей команды composer:

composer require phpunit/phpunit:^5.0

или путем добавления его вручную в composer.json:

{
    "require-dev": {
        "phpunit/phpunit": "^5.0"
    }
}

После установки phpunit создайте каталог «tests» в корневом каталоге:

app/
public/
tests/

Далее, нам нужен файл «helper», чтобы запустить приложение для тестирования.

Файл помощника PHPunit

Файл помощника необходим для запуска приложения для выполнения тестов. Мы подготовили пример файла. Поместите файл в каталог tests/ как TestHelper.php.

use Phalcon\Di;
use Phalcon\Di\FactoryDefault;
use Phalcon\Loader;

ini_set("display_errors", 1);
error_reporting(E_ALL);

define("ROOT_PATH", __DIR__);

set_include_path(
    ROOT_PATH . PATH_SEPARATOR . get_include_path()
);

// Required for phalcon/incubator
include __DIR__ . "/../vendor/autoload.php";

// Use the application autoloader to autoload the classes
// Autoload the dependencies found in composer
$loader = new Loader();

$loader->registerDirs(
    [
        ROOT_PATH,
    ]
);

$loader->register();

$di = new FactoryDefault();

Di::reset();

// Add any needed services to the DI here

Di::setDefault($di);

Если вам нужно протестировать какие-либо компоненты из вашей собственной библиотеки, добавьте их в автозагрузчик или используйте автозагрузчик из вашего основного приложения.

Чтобы помочь вам создать модульные тесты, мы создали несколько абстрактных классов, которые вы можете использовать для запуска модульных тестов. Эти файлы находятся в инкубаторе Phalcon по адресу @ https://github.com/phalcon/incubator.

Вы можете использовать библиотеку инкубатора, добавив её как зависимость:

composer require phalcon/incubator

или путем добавления её вручную в composer.json:

{
    "require": {
        "phalcon/incubator": "^3.0"
    }
}

Вы также можете клонировать репозиторий, используя ссылку на репозиторий выше.

Файл phpunit.xml

Теперь создайте файл phpunit:

<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="./TestHelper.php"
         backupGlobals="false"
         backupStaticAttributes="false"
         verbose="true"
         colors="false"
         convertErrorsToExceptions="true"
         convertNoticesToExceptions="true"
         convertWarningsToExceptions="true"
         processIsolation="false"
         stopOnFailure="false"
         syntaxCheck="true">
    <testsuite name="Phalcon - Testsuite">
        <directory>./</directory>
    </testsuite>
</phpunit>

Измените файл phpunit.xml в соответствии со своими потребностями и сохраните его в каталоге tests/.

Это запустит все тесты в каталоге tests/.

Пример модульного теста

Для выполнения модульных тестов необходимо их определить. Автозагрузчик позаботится о загрузке соответствующих файлов, поэтому всё, что вам нужно сделать, это создать файлы, а phpunit выполнит тесты за вас.

В этом примере отсутствует файл конфигурации, однако большинство тестовых случаев требуют его. Вы можете добавить его в DI, чтобы получить файл UnitTestCase.

Сначала создайте базовый модульный тест под названием UnitTestCase.php в каталоге /tests:

use Phalcon\Di;
use Phalcon\Test\UnitTestCase as PhalconTestCase;

abstract class UnitTestCase extends PhalconTestCase
{
    /**
     * @var bool
     */
    private $_loaded = false;



    public function setUp()
    {
        parent::setUp();

        // Load any additional services that might be required during testing
        $di = Di::getDefault();

        // Get any DI components here. If you have a config, be sure to pass it to the parent

        $this->setDi($di);

        $this->_loaded = true;
    }

    /**
     * Check if the test case is setup properly
     *
     * @throws \PHPUnit_Framework_IncompleteTestError;
     */
    public function __destruct()
    {
        if (!$this->_loaded) {
            throw new \PHPUnit_Framework_IncompleteTestError(
                "Please run parent::setUp()."
            );
        }
    }
}

Всегда рекомендуется отделять модульные тесты по пространствам имён. Для этого теста мы создадим пространство имён «Test». Поэтому создайте файл testsTestUnitTest.php:

namespace Test;

/**
 * Class UnitTest
 */
class UnitTest extends \UnitTestCase
{
    public function testTestCase()
    {
        $this->assertEquals(
            "works",
            "works",
            "This is OK"
        );

        $this->assertEquals(
            "works",
            "works1",
            "This will fail"
        );
    }
}

Теперь, когда вы выполните «phpunit» в командной строке из каталога tests, вы получите следующий вывод:

$ phpunit
PHPUnit 3.7.23 by Sebastian Bergmann.

Configuration read from /private/var/www/tests/phpunit.xml

Time: 3 ms, Memory: 3.25Mb

There was 1 failure:

1) Test\UnitTest::testTestCase
This will fail
Failed asserting that two strings are equal.
--- Expected
+++ Actual
@@ @@
-'works'
+'works1'

/private/var/www/tests/Test/UnitTest.php:25

FAILURES!
Tests: 1, Assertions: 2, Failures: 1.

Теперь вы можете начать создание модульных тестов. Вы можете ознакомиться с хорошим руководством здесь (мы также рекомендуем прочитать документацию PHPunit, если вы не знакомы с PHPunit):

http://blog.stevensanderson.com/2009/08/24/writing-great-unit-tests-best-and-worst-practises/