symfony/dotenv
53.4
Adequate · 17 November 2026
1.1k
lines of production code
PHP
primary language
5
measurements over time
What this system is
Features
New dotenv:dump and debug:dotenv console commands
The Dotenv component now includes two new console commands: \dotenv:dump\ compiles .env files into a PHP-optimized \.env.local.php\ file for production use, and \debug:dotenv\ lists all dotenv files and their variables, supporting filtering by variable name. These commands allow developers to manage and inspect environment variable configurations directly from the command line.
Command · high confidence
Behavioural changes
Dotenv component behavior changes and new loading methods
The Dotenv component now introduces \bootEnv()\ and \loadEnv()\ methods to simplify environment loading, with \bootEnv()\ checking for a pre-compiled \.env.local.php\ file first. The \loadEnv()\ method automatically loads \.env.local\ and environment-specific files (\.env.$env\) while ignoring \.env.local\ in test environments. Environment variable parsing has been updated to allow variable names starting with underscores and supports deferred variable expansion to handle overrides from subsequent files correctly. The \usePutenv\ property default is removed, disabling \putenv()\ by default for thread safety. Additionally, the \debug:dotenv\ command now supports filtering variables, and a new \dotenv:dump\ command allows compiling \.env\ files into a PHP-optimized \.env.local.php\ file.
(repo-wide) · high confidence
Dotenv exception classes updated for PHP 7+ compatibility and new error type
The Dotenv component's exception hierarchy has been modernized: the ExceptionInterface now extends \\Throwable, allowing it to catch broader error types. Specific exception classes (FormatException, PathException) now accept ?\\Throwable for the previous exception instead of \\Exception, and their constructors and properties use strict type hints (string, int) with promoted properties. A new VariableCircularReferenceException has been added to handle circular variable indirection errors. These changes improve type safety and align with modern PHP standards.
Exception · high confidence
Test coverage
Added tests for Dotenv debug and dump commands; Updated Dotenv parser tests to PHPUnit 9+ attributes and expanded coverage.
Dependencies
Update PHP requirement and Symfony dependencies
The minimum PHP version has been raised to 8.4.1, and development dependencies have been updated to use Symfony Console and Process versions 7.4 or 8.0. Additionally, legacy configuration such as the branch-alias has been removed from the manifest.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 53.6 → 53.4 (-0.2)
- Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 63.9 → 62.3 (-1.6)
- Architecture 69.0 → 69.0 (0.0)
- Maturity 47.9 → 47.9 (0.0)
- Readiness 46.8 → 46.8 (0.0)
- Security 100.0 → 100.0 (0.0)
New (3)
- Edited copy of a member (12 corresponding lines) (Command/DebugCommand.php)
- Edited copy of a member (34 corresponding lines) (Dotenv.php)
- Off the main sequence: Exception
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
symfony/dotenv was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 1da3ae3c05f4ea227986ad01dcb8d9190b7bafaa — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.