From 24c8bbbcd43f1aedf211d23d8d453911a6a750cf Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Mon, 17 Jun 2024 08:15:55 +0200
Subject: [PATCH] feat(env processor): add doc/help on `APP_SECRET` env var not
 found exception

---
 .../DependencyInjection/EnvVarProcessor.php        | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/Symfony/Component/DependencyInjection/EnvVarProcessor.php b/src/Symfony/Component/DependencyInjection/EnvVarProcessor.php
index 8f4d588d89cac..ba50c6b4049ed 100644
--- a/src/Symfony/Component/DependencyInjection/EnvVarProcessor.php
+++ b/src/Symfony/Component/DependencyInjection/EnvVarProcessor.php
@@ -218,7 +218,19 @@ public function getEnv(string $prefix, string $name, \Closure $getEnv): mixed
 
             if (false === $env) {
                 if (!$this->container->hasParameter("env($name)")) {
-                    throw new EnvNotFoundException(sprintf('Environment variable not found: "%s".', $name));
+                    $message = sprintf('Environment variable not found: "%s".', $name);
+
+                    // Symfony internal
+                    if ('APP_SECRET' === $name) {
+                        $message = <<<MESSAGE
+Environment variable not found: "APP_SECRET" that is needed for security reason.
+Define it in your .env file via `php -r 'file_put_contents(".env", "\nAPP_SECRET=" . bin2hex(random_bytes(16)), FILE_APPEND);'` or manually as a strong and secure token
+or in your vault via `php bin/console secrets:set APP_SECRET --random`
+Read more at https://symfony.com/doc/current/configuration.html#configuration-based-on-environment-variables
+MESSAGE;
+                    }
+
+                    throw new EnvNotFoundException($message);
                 }
 
                 $env = $this->container->getParameter("env($name)");