Use env variables instead of constants

.env.example

@@ -0,0 +1,2 @@
+YII_ENV=
+YII_DEBUG=true

composer.json

@@ -14,6 +14,9 @@
         "test-watch": "phpunit-watcher watch",
         "post-update-cmd": [
             "App\\Installer::postUpdate"
+        ],
+        "post-create-project-cmd": [
+            "php -r \"copy('.env.example', '.env');\""
         ]
     },
     "require": {
@@ -23,6 +26,7 @@
         "psr/http-message": "^1.0",
         "psr/http-server-handler": "^1.0",
         "symfony/console": "^5.3",
+        "vlucas/phpdotenv": "^5.3",
         "yiisoft/aliases": "^2.0",
         "yiisoft/assets": "^1.0",
         "yiisoft/cache": "^1.0",
@@ -42,12 +46,12 @@
         "yiisoft/log-target-file": "^1.0",
         "yiisoft/router": "@dev",
         "yiisoft/router-fastroute": "@dev",
-        "yiisoft/view": "^2.0",
+        "yiisoft/view": "^3.0",
         "yiisoft/yii-bulma": "@dev",
         "yiisoft/yii-console": "3.0.x-dev",
         "yiisoft/yii-debug": "^3.0@dev",
         "yiisoft/yii-event": "^1.0",
-        "yiisoft/yii-view": "^2.0",
+        "yiisoft/yii-view": "^3.0",
         "yiisoft/yii-web": "^3.0@dev"
     },
     "require-dev": {

config/params.php

@@ -3,7 +3,7 @@
 declare(strict_types=1);
 
 use App\Command\Hello;
-use App\ViewInjection\ContentViewInjection;
+use App\ViewInjection\CommonViewInjection;
 use App\ViewInjection\LayoutViewInjection;
 use Yiisoft\Definitions\Reference;
 use Yiisoft\Yii\View\CsrfViewInjection;
@@ -34,7 +34,7 @@
 
     'yiisoft/yii-view' => [
         'injections' => [
-            Reference::to(ContentViewInjection::class),
+            Reference::to(CommonViewInjection::class),
             Reference::to(CsrfViewInjection::class),
             Reference::to(LayoutViewInjection::class),
         ],

environment.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+use Dotenv\Dotenv;
+
+$dotenv = Dotenv::createImmutable(__DIR__);
+$dotenv->load();
+
+$_ENV['YII_ENV'] = empty($_ENV['YII_ENV']) ? null : (string)$_ENV['YII_ENV'];
+$_SERVER['YII_ENV'] = $_ENV['YII_ENV'];
+
+$_ENV['YII_DEBUG'] = filter_var(
+    !empty($_ENV['YII_DEBUG']) ? $_ENV['YII_DEBUG'] : true,
+    FILTER_VALIDATE_BOOLEAN,
+    FILTER_NULL_ON_FAILURE
+) ?? true;
+$_SERVER['YII_DEBUG'] = $_ENV['YII_DEBUG'];

psalm.xml

@@ -7,7 +7,13 @@
     xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
 >
     <projectFiles>
-        <directory name="src" />
+        <directory name="src"/>
+        <file name="public/index.php"/>
+        <file name="yii"/>
     </projectFiles>
+    <globals>
+        <var name="_ENV['YII_ENV']" type="string|null"/>
+        <var name="_ENV['YII_DEBUG']" type="bool"/>
+    </globals>
 </psalm>
 

public/index.php

@@ -2,11 +2,17 @@
 
 declare(strict_types=1);
 
+use App\Runner\Environment;
 use App\Runner\WebApplicationRunner;
 
+/**
+ * @psalm-var string $_SERVER['REQUEST_URI']
+ */
+
 // PHP built-in server routing.
 if (PHP_SAPI === 'cli-server') {
     // Serve static files as is.
+    /** @psalm-suppress MixedArgument */
     $path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
     if (is_file(__DIR__ . $path)) {
         return false;
@@ -18,19 +24,16 @@
 
 require_once dirname(__DIR__) . '/vendor/autoload.php';
 
-/**
- *  Set debug value for web application runner, for default its `true` add additionally the validation of the
- *  container-di configurations (debug mode).
- */
-define('YII_DEBUG', getenv('YII_DEBUG') ?: true);
+// Setup environment variables
+require_once dirname(__DIR__) . '/environment.php';
 
-/**
- *  Set environment value for web application runner, for default its `null`.
- *
- *  @link https://github.com/yiisoft/config#environments
- */
-define('YII_ENV', getenv('YII_ENV') ?: null);
+if ($_ENV['YII_ENV'] === 'test') {
+    $c3 = dirname(__DIR__) . '/c3.php';
+    if (file_exists($c3)) {
+        require_once $c3;
+    }
+}
 
 // Run web application runner
-$runner = new WebApplicationRunner(YII_DEBUG, YII_ENV);
+$runner = new WebApplicationRunner($_ENV['YII_DEBUG'], $_ENV['YII_ENV']);
 $runner->run();

resources/views/site/index.php

@@ -2,9 +2,10 @@
 
 declare(strict_types=1);
 
-/** @var App\ApplicationParameters $applicationParameters */
-
-$this->params['breadcrumbs'] = '/';
+/**
+ * @var \Yiisoft\View\WebView $this
+ * @var \App\ApplicationParameters $applicationParameters
+ */
 
 $this->setTitle($applicationParameters->getName());
 ?>

src/Installer.php

@@ -17,6 +17,7 @@ public static function postUpdate(): void
     {
         self::chmodRecursive('runtime', 0777);
         self::chmodRecursive('public/assets', 0777);
+        self::copyEnvFile();
     }
 
     private static function chmodRecursive(string $path, int $mode): void
@@ -33,4 +34,11 @@ private static function chmodRecursive(string $path, int $mode): void
             chmod($item, $mode);
         }
     }
+
+    public static function copyEnvFile(): void
+    {
+        if (!file_exists('.env')) {
+            copy('.env.example', '.env');
+        }
+    }
 }

src/Runner/ConsoleApplicationRunner.php

@@ -15,8 +15,11 @@
 use Yiisoft\Definitions\Exception\NotFoundException;
 use Yiisoft\Definitions\Exception\NotInstantiableException;
 use Yiisoft\Yii\Console\Application;
+use Yiisoft\Yii\Console\ExitCode;
 use Yiisoft\Yii\Console\Output\ConsoleBufferedOutput;
 
+use function dirname;
+
 final class ConsoleApplicationRunner
 {
     private bool $debug;
@@ -61,7 +64,7 @@ public function run(): void
 
         /** @var Application */
         $application = $container->get(Application::class);
-        $exitCode = 1;
+        $exitCode = ExitCode::UNSPECIFIED_ERROR;
 
         try {
             $application->start();

src/Runner/WebApplicationRunner.php

@@ -135,9 +135,7 @@ private function emit(RequestInterface $request, ResponseInterface $response): v
      */
     private function registerErrorHandler(ErrorHandler $registered, ErrorHandler $unregistered = null): void
     {
-        if ($unregistered !== null) {
-            $unregistered->unregister();
-        }
+        $unregistered?->unregister();
 
         if ($this->debug) {
             $registered->debug();

src/ViewInjection/ContentViewInjection.php → src/ViewInjection/CommonViewInjection.php

@@ -5,9 +5,9 @@
 namespace App\ViewInjection;
 
 use App\ApplicationParameters;
-use Yiisoft\Yii\View\ContentParametersInjectionInterface;
+use Yiisoft\Yii\View\CommonParametersInjectionInterface;
 
-final class ContentViewInjection implements ContentParametersInjectionInterface
+final class CommonViewInjection implements CommonParametersInjectionInterface
 {
     private ApplicationParameters $applicationParameters;
 
@@ -17,7 +17,7 @@ public function __construct(
         $this->applicationParameters = $applicationParameters;
     }
 
-    public function getContentParameters(): array
+    public function getCommonParameters(): array
     {
         return [
             'applicationParameters' => $this->applicationParameters,

src/ViewInjection/LayoutViewInjection.php

@@ -4,7 +4,6 @@
 
 namespace App\ViewInjection;
 
-use App\ApplicationParameters;
 use Yiisoft\Assets\AssetManager;
 use Yiisoft\I18n\Locale;
 use Yiisoft\Router\UrlGeneratorInterface;
@@ -13,20 +12,17 @@
 
 final class LayoutViewInjection implements LayoutParametersInjectionInterface
 {
-    private ApplicationParameters $applicationParameters;
     private AssetManager $assetManager;
     private Locale $locale;
     private UrlGeneratorInterface $urlGenerator;
     private CurrentRoute $currentRoute;
 
     public function __construct(
-        ApplicationParameters $applicationParameters,
         AssetManager $assetManager,
         Locale $locale,
         UrlGeneratorInterface $urlGenerator,
         CurrentRoute $currentRoute
     ) {
-        $this->applicationParameters = $applicationParameters;
         $this->assetManager = $assetManager;
         $this->locale = $locale;
         $this->urlGenerator = $urlGenerator;
@@ -36,7 +32,6 @@ public function __construct(
     public function getLayoutParameters(): array
     {
         return [
-            'applicationParameters' => $this->applicationParameters,
             'assetManager' => $this->assetManager,
             'locale' => $this->locale,
             'urlGenerator' => $this->urlGenerator,

yii

@@ -7,19 +7,9 @@ use App\Runner\ConsoleApplicationRunner;
 
 require_once __DIR__ . '/vendor/autoload.php';
 
-/**
- *  Set debug value for console application runner, for default its `true` add additionally the validation of the
- *  container-di configurations (debug mode).
- */
-define('YII_DEBUG', getenv('YII_DEBUG') ?: true);
+// Setup environment variables
+require_once __DIR__ . '/environment.php';
 
-/**
- *  Set environment value for web application runner, for default its `null`.
- *
- *  @link https://github.com/yiisoft/config#environments
- */
-define('YII_ENV', getenv('YII_ENV') ?: null);
-
-// Run console application runner
-$consoleRunner = new ConsoleApplicationRunner(YII_DEBUG, YII_ENV);
-$consoleRunner->run();
+// Run web application runner
+$runner = new ConsoleApplicationRunner($_ENV['YII_DEBUG'], $_ENV['YII_ENV']);
+$runner->run();