初始化载入配置

Testing Is Documentation

tests/Kernel/Bootstrap/LoadOptionTest.php初始化载入配置 - 图1

QueryPHP 在内核执行过程中会执行初始化，分为 4 个步骤，载入配置、载入语言包、注册异常运行时和遍历服务提供者注册服务。

内核初始化，包括 \Leevel\Kernel\IKernel::bootstrap 和 \Leevel\Kernel\IKernelConsole::bootstrap 均会执行上述 4 个步骤。

Uses

  1. <?php
  3. use Leevel\Di\Container;
  4. use Leevel\Di\IContainer;
  5. use Leevel\Filesystem\Helper;
  6. use Leevel\Kernel\App as Apps;
  7. use Leevel\Kernel\Bootstrap\LoadOption;
  8. use Leevel\Kernel\IApp;

基本使用方法

fixture 定义

环境变量 tests/Kernel/Bootstrap/app/.env

  1. # Environment production、testing and development
  2. ENVIRONMENT = development
  4. # Debug
  5. DEBUG = true
  7. # Encryption key
  8. AUTH_KEY = 7becb888f518b20224a988906df51e05

配置文件 tests/Kernel/Bootstrap/app/option/app.php

  1. <?php
  3. /*
  4.  * This file is part of the ************************ package.
  5.  * _____________                           _______________
  6.  *  ______/     \__  _____  ____  ______  / /_  _________
  7.  *   ____/ __   / / / / _ \/ __`\/ / __ \/ __ \/ __ \___
  8.  *    __/ / /  / /_/ /  __/ /  \  / /_/ / / / / /_/ /__
  9.  *      \_\ \_/\____/\___/_/   / / .___/_/ /_/ .___/
  10.  *         \_\                /_/_/         /_/
  11.  *
  12.  * The PHP Framework For Code Poem As Free As Wind. <Query Yet Simple>
  13.  * (c) 2010-2020 http://queryphp.com All rights reserved.
  14.  *
  15.  * For the full copyright and license information, please view the LICENSE
  16.  * file that was distributed with this source code.
  17.  */
  19. return [
  20.     'environment' => getenv('ENVIRONMENT'),
  21.     'debug'       => false,
  22. ];

配置文件 tests/Kernel/Bootstrap/app/option/demo.php

  1. <?php
  3. /*
  4.  * This file is part of the ************************ package.
  5.  * _____________                           _______________
  6.  *  ______/     \__  _____  ____  ______  / /_  _________
  7.  *   ____/ __   / / / / _ \/ __`\/ / __ \/ __ \/ __ \___
  8.  *    __/ / /  / /_/ /  __/ /  \  / /_/ / / / / /_/ /__
  9.  *      \_\ \_/\____/\___/_/   / / .___/_/ /_/ .___/
  10.  *         \_\                /_/_/         /_/
  11.  *
  12.  * The PHP Framework For Code Poem As Free As Wind. <Query Yet Simple>
  13.  * (c) 2010-2020 http://queryphp.com All rights reserved.
  14.  *
  15.  * For the full copyright and license information, please view the LICENSE
  16.  * file that was distributed with this source code.
  17.  */
  19. return [
  20.     'foo' => 'bar',
  21. ];
  1. public function testBaseUse(): void
  2. {
  3.     $bootstrap = new LoadOption();
  5.     $container = Container::singletons();
  6.     $app = new App3($container, $appPath = __DIR__.'/app');
  8.     $this->assertInstanceof(IContainer::class, $container);
  9.     $this->assertInstanceof(Container::class, $container);
  10.     $this->assertInstanceof(IApp::class, $app);
  11.     $this->assertInstanceof(Apps::class, $app);
  13.     $this->assertSame($appPath.'/bootstrap/option.php', $app->optionCachedPath());
  14.     $this->assertFalse($app->isCachedOption());
  15.     $this->assertSame($appPath.'/option', $app->optionPath());
  17.     $this->assertNull($bootstrap->handle($app, true));
  19.     $option = $container->make('option');
  21.     $this->assertSame('development', $option->get('environment'));
  22.     $this->assertSame('bar', $option->get('demo\\foo'));
  23. }

RUNTIME_ENVIRONMENT 载入自定义环境变量文件

设置 RUNTIME_ENVIRONMENT 环境变量可以载入自定义环境变量文件。

fixture 定义

环境变量 tests/Kernel/Bootstrap/app/.fooenv

  1. # Environment production、testing and development
  2. ENVIRONMENT = testing
  4. # Debug
  5. DEBUG = true
  7. # Encryption key
  8. AUTH_KEY = 7becb888f518b20224a988906df51e05
  1. public function testWithRuntimeEnv(): void
  2. {
  3.     putenv('RUNTIME_ENVIRONMENT=fooenv');
  5.     $bootstrap = new LoadOption();
  7.     $container = Container::singletons();
  8.     $app = new App3($container, $appPath = __DIR__.'/app');
  10.     $this->assertInstanceof(IContainer::class, $container);
  11.     $this->assertInstanceof(Container::class, $container);
  12.     $this->assertInstanceof(IApp::class, $app);
  13.     $this->assertInstanceof(Apps::class, $app);
  15.     $this->assertSame($appPath.'/bootstrap/fooenv.php', $app->optionCachedPath());
  16.     $this->assertFalse($app->isCachedOption());
  17.     $this->assertSame($appPath.'/option', $app->optionPath());
  19.     $this->assertNull($bootstrap->handle($app, true));
  21.     $option = $container->make('option');
  23.     $this->assertSame('testing', $option->get('environment'));
  24.     $this->assertSame('bar', $option->get('demo\\foo'));
  25. }

配置支持缓存

配置文件支持缓存，通过缓存可以降低开销提高性能，适合生产环境。

fixture 定义

配置缓存文件 tests/Kernel/Bootstrap/app/assert/option.php

  1. <?php
  3. /*
  4.  * This file is part of the ************************ package.
  5.  * _____________                           _______________
  6.  *  ______/     \__  _____  ____  ______  / /_  _________
  7.  *   ____/ __   / / / / _ \/ __`\/ / __ \/ __ \/ __ \___
  8.  *    __/ / /  / /_/ /  __/ /  \  / /_/ / / / / /_/ /__
  9.  *      \_\ \_/\____/\___/_/   / / .___/_/ /_/ .___/
  10.  *         \_\                /_/_/         /_/
  11.  *
  12.  * The PHP Framework For Code Poem As Free As Wind. <Query Yet Simple>
  13.  * (c) 2010-2020 http://queryphp.com All rights reserved.
  14.  *
  15.  * For the full copyright and license information, please view the LICENSE
  16.  * file that was distributed with this source code.
  17.  */
  19. return [
  20.     'app' => [
  21.         'environment' => 'development',
  22.         'debug'       => false,
  23.         ':env'        => [
  24.             'environment'  => 'development',
  25.             'debug'        => true,
  26.             'app_auth_key' => '7becb888f518b20224a988906df51e05',
  27.             'foo'          => null,
  28.         ],
  29.         ':deferred_providers' => [
  30.             0 => [
  31.             ],
  32.             1 => [
  33.             ],
  34.         ],
  35.         ':composer' => [
  36.             'providers' => [
  37.             ],
  38.             'ignores' => [
  39.             ],
  40.             'commands' => [
  41.             ],
  42.             'options' => [
  43.             ],
  44.             'i18ns' => [
  45.             ],
  46.             'metas' => [
  47.             ],
  48.         ],
  49.     ],
  50.     'demo' => [
  51.         'foo' => 'bar',
  52.     ],
  53. ];
  1. public function testLoadCached(): void
  2. {
  3.     $bootstrap = new LoadOption();
  5.     $container = Container::singletons();
  6.     $app = new App3($container, $appPath = __DIR__.'/app');
  8.     $this->assertInstanceof(IContainer::class, $container);
  9.     $this->assertInstanceof(Container::class, $container);
  10.     $this->assertInstanceof(IApp::class, $app);
  11.     $this->assertInstanceof(Apps::class, $app);
  13.     $this->assertSame($appPath.'/bootstrap/option.php', $app->optionCachedPath());
  14.     $this->assertFalse($app->isCachedOption());
  15.     $this->assertSame($appPath.'/option', $app->optionPath());
  17.     mkdir($appPath.'/bootstrap', 0777, true);
  18.     file_put_contents($appPath.'/bootstrap/option.php', file_get_contents($appPath.'/assert/option.php'));
  20.     $this->assertTrue($app->isCachedOption());
  22.     $this->assertNull($bootstrap->handle($app, true));
  24.     $option = $container->make('option');
  26.     $this->assertSame('development', $option->get('environment'));
  27.     $this->assertSame('bar', $option->get('demo\\foo'));
  28.     $this->assertNull($option->get(':env.foo'));
  29.     $this->assertTrue($option->get(':env.debug'));
  30. }