Pre-release 4.2.126 → 4.2.125 — task 4.5 (config): .env files load with v13's LoadEnvironmentVariables

[oonid]

Task 4.5, config — .env files load with v13's LoadEnvironmentVariables

Stacks on #98. This is the third config slice. v13 reads the environment from a dotenv .env file. The fork read only the L4.2 .env.{env}.php arrays. The start script now loads .env first with v13's LoadEnvironmentVariables and vlucas/phpdotenv, then the .env.{env}.php file as before. That file still wins on the keys both define, so an application with no .env file sees no change. Environment files can then move to .env one deployment at a time, before the APP_ENV slice drops the hostname map.

Changes

• Illuminate\Foundation\Bootstrap\LoadEnvironmentVariables uses v13's name and file selection:

  • It reads .env from environmentPath(), the base path by default.
  • It reads .env.{env} instead when the console's --env option or the APP_ENV variable names an environment that has its own file.
  • Variables already in the process environment are kept: v13's Env repository is immutable.
  • A missing file loads nothing.
  • The config cache check and the invalid-file message are left out. They come with the flip.

• The start script runs it just before the .env.{env}.php file loads, so the PHP file's values win on shared keys.

• Application gains v13's environmentPath(), useEnvironmentPath(), loadEnvironmentFrom(), environmentFile() and environmentFilePath().

• vlucas/phpdotenv ^5.6.1 becomes a requirement. It is what v13's Env class and the env() helper in illuminate/support need, so env() now works too.

• Tests: a new FoundationLoadEnvironmentVariablesTest (7 tests) checks that:

  • .env loads into getenv(), $_ENV, $_SERVER and env();
  • --env and APP_ENV each pick .env.{env};
  • an environment without its own file falls back to .env;
  • variables already in the environment are kept;
  • a missing .env loads nothing;
  • useEnvironmentPath() moves where .env is read from.

  FoundationApplicationBuilderTest checks that the start script loads .env and that .env.testing.php wins on a shared key.

What changes

• An invalid .env stops the app. phpdotenv rejects lines such as KEY=a b, and the start script lets its InvalidFileException through. In the dicoding app, artisan exits 255 with the message and a stack trace, and HTTP requests get a 500 with an empty body and the message in the server log. v13 prints "The environment file is invalid!" and exits 1. phpdotenv doesn't reject an unterminated quote such as KEY="abc; that line loads nothing.

Verification

• Fork: the suite is 286 green on PHPUnit 11.5.56. The ratchet is green, with every pattern at its baseline.
• The tests catch real breaks. Each of these 6 mutations fails at least one test:
  • the start script not loading .env;
  • --env ignored;
  • APP_ENV ignored;
  • a missing .env.{env} not checked;
  • useEnvironmentPath() ignored;
  • dotenv never loading.
• Downstream: the dicoding app pair is dicoding-dev/dicoding#6003 (feature/platform/framework-4.2.126-rc1). It pins this release, and its lock gains vlucas/phpdotenv and its two dependencies. It ran with vendor installed from its lock, apart from the dev CLIs phpstan/phpstan and rector/rector, whose GitHub downloads are refused in this container:
  • config()->all() is byte-identical to 4.2.125 in production, local, testing and endtoend.
  • .env loading, probed by booting the app's console kernel: a valid .env reaches env() and getenv(), and none leaves them empty.
  • Psalm (full project, no cache): no errors.
  • Unit suite: 8964 green.
  • Integration suite: all 3023 tests. The only failures are the 4 long-standing ones. 191 are skipped and 5 incomplete, and no test is flagged risky.
  • The real entry points (php -S + server.php → index.php, and 7 artisan commands) and the 13 in-process request scenarios are identical to 4.2.125.
• Checks ran in a cloud container without deck (PHP 8.4.26, MariaDB 10.11).

Tag

There's no 4.2.126 tag, as there are none for 4.2.119–4.2.125: tag pushes are refused for this session. The app pins the pre-release/4.2.126 branch (84d2f6ac).

🤖 Generated with Claude Code

https://claude.ai/code/session_0169SsatCE8LhaTsQTPiGtVo