应用 ¶

Testing Is Documentation

应用是整个系统非常核心的一部分，定义了应用的骨架。

Uses

php

<?php

use Leevel\Di\Container;
use Leevel\Di\IContainer;
use Leevel\Di\Provider;
use Leevel\Filesystem\Helper;
use Leevel\Http\Request;
use Leevel\Kernel\App as Apps;
use Leevel\Kernel\IApp;
use Leevel\Option\IOption;

基本使用 ¶

php

public function testBaseUse(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();
    $container = $app->container();

    $this->assertInstanceof(IContainer::class, $container);
    $this->assertInstanceof(Container::class, $container);
    $this->assertInstanceof(IApp::class, $app);
    $this->assertInstanceof(Apps::class, $app);

    static::assertSame($appPath, $app->path());
    static::assertSame($appPath.'/foobar', $app->path('foobar'));
}

version 获取程序版本 ¶

php

public function testVersion(): void
{
    $app = $this->createApp();

    static::assertSame(App::VERSION, $app->version());
}

isConsole 是否为 PHP 运行模式命令行 ¶

php

public function testIsConsole(): void
{
    $app = $this->createApp();

    static::assertTrue($app->isConsole());
}

setPath 设置基础路径 ¶

php

public function testSetPath(): void
{
    $app = $this->createApp();

    $app->setPath(__DIR__.'/foo');

    static::assertSame(__DIR__.'/foo', $app->path());
}

appPath 获取应用路径 ¶

php

public function testAppPath(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();
    $container = $app->container();

    $request = $this->createMock(Request::class);
    $container->singleton('request', function () use ($request) {
        return $request;
    });

    static::assertSame($appPath, $app->appPath());
    static::assertSame($appPath, $app->appPath(''));
    static::assertSame($appPath.'/foo', $app->appPath('foo'));
    static::assertSame($appPath.'/bar', $app->appPath('bar'));
    static::assertSame($appPath.'/foo/foo/bar', $app->appPath('foo/foo/bar'));
    static::assertSame($appPath.'/bar/foo/bar', $app->appPath('bar/foo/bar'));
}

setAppPath 设置应用路径 ¶

php

public function testSetAppPath(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();
    $container = $app->container();

    $request = $this->createMock(Request::class);
    $container->singleton('request', function () use ($request) {
        return $request;
    });

    static::assertSame($appPath, $app->appPath());
    $app->setAppPath(__DIR__.'/app/foo');
    static::assertSame($appPath.'/foo', $app->appPath());
}

storagePath 获取运行路径 ¶

php

public function testStoragePath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath.'/storage', $app->storagePath());
    static::assertSame($appPath.'/storage/foobar', $app->storagePath('foobar'));
}

setStoragePath 设置运行时路径 ¶

php

public function testSetStoragePath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath.'/storage', $app->storagePath());
    static::assertSame($appPath.'/storage/foobar', $app->storagePath('foobar'));

    $app->setStoragePath(__DIR__.'/app/storageFoo');

    static::assertSame($appPath.'/storageFoo', $app->storagePath());
    static::assertSame($appPath.'/storageFoo/foobar', $app->storagePath('foobar'));
}

optionPath 获取配置路径 ¶

php

public function testOptionPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath.'/option', $app->optionPath());
    static::assertSame($appPath.'/option/foobar', $app->optionPath('foobar'));
}

setOptionPath 设置配置路径 ¶

php

public function testSetOptionPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath.'/option', $app->optionPath());
    static::assertSame($appPath.'/option/foobar', $app->optionPath('foobar'));

    $app->setOptionPath(__DIR__.'/app/optionFoo');

    static::assertSame($appPath.'/optionFoo', $app->optionPath());
    static::assertSame($appPath.'/optionFoo/foobar', $app->optionPath('foobar'));
}

i18nPath 获取语言包路径 ¶

php

public function testI18nPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath.'/assets/i18n', $app->i18nPath());
    static::assertSame($appPath.'/assets/i18n/foobar', $app->i18nPath('foobar'));
}

setI18nPath 设置语言包路径 ¶

php

public function testSetI18nPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath.'/assets/i18n', $app->i18nPath());
    static::assertSame($appPath.'/assets/i18n/foobar', $app->i18nPath('foobar'));

    $app->setI18nPath(__DIR__.'/app/i18nFoo');

    static::assertSame($appPath.'/i18nFoo', $app->i18nPath());
    static::assertSame($appPath.'/i18nFoo/foobar', $app->i18nPath('foobar'));
}

envPath 获取环境变量路径 ¶

php

public function testEnvPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath, $app->envPath());
}

setEnvPath 设置环境变量路径 ¶

php

public function testSetEnvPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath, $app->envPath());

    $app->setEnvPath(__DIR__.'/appFoo');

    static::assertSame(__DIR__.'/appFoo', $app->envPath());
}

envFile 获取环境变量文件 ¶

php

public function testEnvFile(): void
{
    $app = $this->createApp();

    static::assertSame('.env', $app->envFile());
}

setEnvFile 设置环境变量文件 ¶

php

public function testSetEnvFile(): void
{
    $app = $this->createApp();

    static::assertSame('.env', $app->envFile());

    $app->setEnvFile('.envfoo');

    static::assertSame('.envfoo', $app->envFile());
}

fullEnvPath 获取环境变量完整路径 ¶

php

public function testFullEnvPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath.'/.env', $app->fullEnvPath());

    $app->setEnvPath(__DIR__.'/appFoo');

    static::assertSame(__DIR__.'/appFoo/.env', $app->fullEnvPath());

    $app->setEnvFile('.envfoo');

    static::assertSame(__DIR__.'/appFoo/.envfoo', $app->fullEnvPath());
}

i18nCachedPath 获取语言包缓存路径 ¶

php

public function testSetI18nCachePath(): void
{
    $app = $this->createApp();
    static::assertSame(__DIR__.'/app/storage/bootstrap/i18n/zh-CN.php', $app->i18nCachedPath('zh-CN'));
    $app->setI18nCachedPath(__DIR__.'/hello');
    static::assertSame(__DIR__.'/hello/zh-CN.php', $app->i18nCachedPath('zh-CN'));
}

i18nCachedPath 获取语言包缓存路径 ¶

php

public function testI18nCachedPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertSame($appPath.'/storage/bootstrap/i18n/zh-CN.php', $app->i18nCachedPath('zh-CN'));
    static::assertSame($appPath.'/storage/bootstrap/i18n/zh-TW.php', $app->i18nCachedPath('zh-TW'));
    static::assertSame($appPath.'/storage/bootstrap/i18n/en-US.php', $app->i18nCachedPath('en-US'));
}

isCachedI18n 是否存在语言包缓存 ¶

php

public function testIsCachedI18n(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';

    static::assertFalse($app->isCachedI18n('zh-CN'));

    mkdir($appPath.'/storage/bootstrap/i18n', 0o777, true);
    file_put_contents($appPath.'/storage/bootstrap/i18n/zh-CN.php', 'foo');
    static::assertTrue($app->isCachedI18n('zh-CN'));

    Helper::deleteDirectory($appPath);
}

setOptionCachedPath 设置配置缓存路径 ¶

php

public function testSetOptionCachePath(): void
{
    $app = $this->createApp();
    static::assertSame(__DIR__.'/app/storage/bootstrap/option.php', $app->optionCachedPath());
    $app->setOptionCachedPath(__DIR__.'/hello');
    static::assertSame(__DIR__.'/hello/option.php', $app->optionCachedPath());
}

optionCachedPath 获取配置缓存路径 ¶

php

public function testOptionCachedPath(): void
{
    $app = $this->createApp();
    $appPath = __DIR__.'/app';
    static::assertSame($appPath.'/storage/bootstrap/option.php', $app->optionCachedPath());
}

isCachedOption 是否存在配置缓存 ¶

php

public function testIsCachedOption(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();

    static::assertFalse($app->isCachedOption());
    mkdir($appPath.'/storage/bootstrap', 0o777, true);
    file_put_contents($appPath.'/storage/bootstrap/option.php', 'foo');
    static::assertTrue($app->isCachedOption());

    Helper::deleteDirectory($appPath);
}

routerCachedPath 获取路由缓存路径 ¶

php

public function testRouterCachedPath(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();

    static::assertSame($appPath.'/storage/bootstrap/router.php', $app->routerCachedPath());
}

isCachedRouter 是否存在路由缓存 ¶

php

public function testIsCachedRouter(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();

    static::assertFalse($app->isCachedRouter());

    mkdir($appPath.'/storage/bootstrap', 0o777, true);

    file_put_contents($routerPath = $appPath.'/storage/bootstrap/router.php', 'foo');

    static::assertTrue($app->isCachedRouter());

    Helper::deleteDirectory($appPath);
}

namespacePath 获取命名空间目录真实路径 ¶

php

public function testNamespacePath(): void
{
    $appPath = \dirname(__DIR__, 2);
    $app = $this->createApp($appPath);
    $container = $app->container();
    static::assertSame(
        \dirname(__DIR__, 2).'/src/Leevel/Kernel/Console',
        realpath($app->namespacePath('Leevel\\Kernel\\Console'))
    );
}

isDebug 是否开启调试 ¶

php

public function testIsDebug(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();
    $container = $app->container();

    $option = $this->createMock(IOption::class);

    $option
        ->method('get')
        ->willReturnCallback(function (string $k) {
            $map = [
                'debug' => true,
                'environment' => 'development',
            ];

            return $map[$k];
        })
    ;

    static::assertSame('development', $option->get('environment'));
    static::assertTrue($option->get('debug'));

    $container->singleton('option', function () use ($option) {
        return $option;
    });

    static::assertTrue($app->isDebug());
}

isDevelopment 是否为开发环境 ¶

php

public function testIsDevelopment(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();
    $container = $app->container();

    $option = $this->createMock(Request::class);

    $option->method('get')->willReturn('development');
    static::assertSame('development', $option->get('development'));

    $container->singleton('option', function () use ($option) {
        return $option;
    });

    static::assertTrue($app->isDevelopment());
}

environment 获取运行环境 ¶

php

public function testEnvironment(): void
{
    $appPath = __DIR__.'/app';
    $app = $this->createApp();
    $container = $app->container();

    $option = $this->createMock(Request::class);

    $option->method('get')->willReturn('foo');
    static::assertSame('foo', $option->get('development'));

    $container->singleton('option', function () use ($option) {
        return $option;
    });

    static::assertSame('foo', $app->environment());
}

bootstrap 初始化应用 ¶

fixture 定义

Tests\Kernel\BootstrapTest1

php

namespace Tests\Kernel;

class BootstrapTest1
{
    public function handle(): void
    {
        $_SERVER['bootstrapTest1'] = 1;
    }
}

Tests\Kernel\BootstrapTest2

php

namespace Tests\Kernel;

class BootstrapTest2
{
    public function handle(): void
    {
        $_SERVER['bootstrapTest2'] = 1;
    }
}

Tests\Console\Load1\Test1

php

namespace Tests\Console\Load1;

use Leevel\Console\Command;

class Test1 extends Command
{
    protected string $name = 'load1:test1';

    protected string $description = 'load1 test1 for command';

    public function handle(): int
    {
        $this->info('load1 test1');

        return 0;
    }
}

php

public function testBootstrap(): void
{
    $app = $this->createApp();

    $app->bootstrap([BootstrapTest1::class, BootstrapTest2::class]);

    static::assertSame(1, $_SERVER['bootstrapTest1']);
    static::assertSame(1, $_SERVER['bootstrapTest2']);

    unset($_SERVER['bootstrapTest1'], $_SERVER['bootstrapTest2']);
}

registerAppProviders 注册应用服务提供者 ¶

fixture 定义

Tests\Kernel\OptionTest

php

namespace Tests\Kernel;

class OptionTest
{
    public function get(string $name)
    {
        if (':deferred_providers' === $name) {
            return [
                [
                    'foo' => 'Tests\\Kernel\\ProviderDeferTest1',
                ],
                [
                    'Tests\\Kernel\\ProviderDeferTest1' => [
                        'foo' => [
                            'Tests\\Kernel\\ProviderDeferTest1',
                        ],
                    ],
                ],
            ];
        }

        if (':composer.providers' === $name) {
            return [ProviderTest3::class];
        }
    }
}

Tests\Kernel\ProviderTest3

php

namespace Tests\Kernel;

class ProviderTest3 extends Provider
{
    public function __construct(IContainer $container)
    {
    }

    public function bootstrap(): void
    {
        $_SERVER['testRegisterProvidersBootstrap'] = 1;
    }

    public function register(): void
    {
        $_SERVER['testRegisterProvidersRegister'] = 1;
    }
}

Tests\Kernel\ProviderDeferTest1

php

namespace Tests\Kernel;

class ProviderDeferTest1 extends Provider
{
    public function register(): void
    {
        $_SERVER['providerDeferTest1'] = 1;

        $this->container->singleton('foo', function (IContainer $container) {
            return 'bar';
        });
    }

    public static function providers(): array
    {
        return [
            'foo' => [
                'Tests\\Kernel\\ProviderDeferTest1',
            ],
        ];
    }

    public static function isDeferred(): bool
    {
        return true;
    }
}

php

public function testRegisterProviders(): void
{
    $app = $this->createApp();
    $container = $app->container();

    $option = new OptionTest();
    $container->singleton('option', function () use ($option) {
        return $option;
    });

    $app->registerAppProviders();

    // for deferredAlias
    static::assertArrayNotHasKey('providerDeferTest1', $_SERVER);
    static::assertSame('bar', $container->make('foo'));
    static::assertSame('bar', $container->make(ProviderDeferTest1::class));
    static::assertSame(1, $_SERVER['providerDeferTest1']);

    // for providers
    static::assertSame(1, $_SERVER['testRegisterProvidersRegister']);
    static::assertArrayHasKey('testRegisterProvidersBootstrap', $_SERVER);

    unset(
        $_SERVER['providerDeferTest1'],
        $_SERVER['testRegisterProvidersRegister']
    );

    // bootstrap
    static::assertTrue($container->isBootstrap());
    static::assertSame(1, $_SERVER['testRegisterProvidersBootstrap']);
    unset($_SERVER['testRegisterProvidersBootstrap']);
    static::assertTrue($container->isBootstrap());

    // again but already bootstrap
    $app->registerAppProviders();
    static::assertArrayNotHasKey('testRegisterProvidersBootstrap', $_SERVER);
    static::assertArrayNotHasKey('testRegisterProvidersRegister', $_SERVER);
}

setThemesPath 设置主题路径 ¶

php

public function testSetThemesPath(): void
{
    $app = $this->createApp();
    static::assertSame(__DIR__.'/app/assets/themes', $app->themesPath());
    $app->setThemesPath(__DIR__.'/hello');
    static::assertSame(__DIR__.'/hello', $app->themesPath());
}

env 获取应用的环境变量 ¶

测试数据

php

# Tests\Kernel\AppTest::envProvider
public static function envProvider(): array
{
    return [
        ['bar', 'true', true],
        ['bar', '(true)', true],
        ['bar', 'false', false],
        ['bar', '(false)', false],
        ['bar', 'empty', ''],
        ['bar', '(empty)', ''],
        ['bar', 'null', null],
        ['bar', '(null)', null],
        ['bar', '"hello"', 'hello'],
        ['bar', "'hello'", "'hello'"],
        ['bar', true, '1'],
        ['bar', false, ''],
        ['bar', 1, '1'],
        ['bar', '', ''],
    ];
}

php

public function testEnv(string $name, $value, $envValue): void
{
    $app = $this->createApp();
    $name = 'test_env_'.$name;
    putenv($name.'='.$value);
    static::assertSame($envValue, $app->env($name));
}