Skip to content
CAI
Software that uses CAICheck a score

symfony/dotenv

53.4

Adequate · 17 November 2026

1.1k

lines of production code

PHP

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.