TestCase.php 4.14 KB
Newer Older
1
<?php
2 3 4 5 6
/**
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */
7 8 9 10

namespace yii\codeception;

use Yii;
Qiang Xue committed
11
use yii\base\InvalidConfigException;
12
use Codeception\TestCase\Test;
13 14 15
use yii\base\UnknownMethodException;
use yii\base\UnknownPropertyException;
use yii\test\ActiveFixture;
16
use yii\test\BaseActiveFixture;
Qiang Xue committed
17
use yii\test\FixtureTrait;
18 19 20 21 22 23 24

/**
 * TestCase is the base class for all codeception unit tests
 *
 * @author Mark Jebri <mark.github@yandex.ru>
 * @since 2.0
 */
25
class TestCase extends Test
26
{
27
    use FixtureTrait;
Qiang Xue committed
28

29 30 31 32 33 34
    /**
     * @var array|string the application configuration that will be used for creating an application instance for each test.
     * You can use a string to represent the file path or path alias of a configuration file.
     * The application configuration array may contain an optional `class` element which specifies the class
     * name of the application instance to be created. By default, a [[\yii\web\Application]] instance will be created.
     */
35
    public $appConfig = '@tests/codeception/config/unit.php';
Qiang Xue committed
36

37

38 39 40 41 42
    /**
     * Returns the value of an object property.
     *
     * Do not call this method directly as it is a PHP magic method that
     * will be implicitly called when executing `$value = $object->property;`.
43 44
     * @param string $name the property name
     * @return mixed the property value
45 46 47 48 49 50 51 52 53 54 55
     * @throws UnknownPropertyException if the property is not defined
     */
    public function __get($name)
    {
        $fixture = $this->getFixture($name);
        if ($fixture !== null) {
            return $fixture;
        } else {
            throw new UnknownPropertyException('Getting unknown property: ' . get_class($this) . '::' . $name);
        }
    }
Mark committed
56

57 58 59 60 61
    /**
     * Calls the named method which is not a class method.
     *
     * Do not call this method directly as it is a PHP magic method that
     * will be implicitly called when an unknown method is being invoked.
62 63
     * @param string $name the method name
     * @param array $params method parameters
64
     * @throws UnknownMethodException when calling unknown method
65
     * @return mixed the method return value
66 67 68 69
     */
    public function __call($name, $params)
    {
        $fixture = $this->getFixture($name);
70
        if ($fixture instanceof BaseActiveFixture) {
71 72 73 74 75
            return $fixture->getModel(reset($params));
        } else {
            throw new UnknownMethodException('Unknown method: ' . get_class($this) . "::$name()");
        }
    }
Mark committed
76

77 78 79 80 81 82 83 84 85 86
    /**
     * @inheritdoc
     */
    protected function setUp()
    {
        parent::setUp();
        $this->mockApplication();
        $this->unloadFixtures();
        $this->loadFixtures();
    }
87

88 89 90 91 92 93 94 95
    /**
     * @inheritdoc
     */
    protected function tearDown()
    {
        $this->destroyApplication();
        parent::tearDown();
    }
96

97 98
    /**
     * Mocks up the application instance.
99 100
     * @param array $config the configuration that should be used to generate the application instance.
     * If null, [[appConfig]] will be used.
101
     * @return \yii\web\Application|\yii\console\Application the application instance
102
     * @throws InvalidConfigException if the application configuration is invalid
103 104 105 106 107 108 109 110 111 112 113 114 115 116 117
     */
    protected function mockApplication($config = null)
    {
        $config = $config === null ? $this->appConfig : $config;
        if (is_string($config)) {
            $configFile = Yii::getAlias($config);
            if (!is_file($configFile)) {
                throw new InvalidConfigException("The application configuration file does not exist: $config");
            }
            $config = require($configFile);
        }
        if (is_array($config)) {
            if (!isset($config['class'])) {
                $config['class'] = 'yii\web\Application';
            }
118

119 120 121 122 123 124 125 126 127 128 129 130 131
            return Yii::createObject($config);
        } else {
            throw new InvalidConfigException('Please provide a configuration array to mock up an application.');
        }
    }

    /**
     * Destroys the application instance created by [[mockApplication]].
     */
    protected function destroyApplication()
    {
        Yii::$app = null;
    }
132
}