NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #236 most downloaded on Packagist
Registers environment variables from a .env file
Latest stable
v8.1.6
Last release 1 months ago
22 Oct 2026
Ships fairly regularly
a new release about every 4 weeks
Rarely documented
notes for 12 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
348 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Changelog ( v8.1.6...v8.2.0-BETA1 )
Changelog (v8.1.6...v8.2.0-BETA1)
command.invocation and migrate command examples (@nicolas-grekas)minor #65724 Declare the polyfills needed by the code on PHP 7.2 ( @nicolas-grekas )
Changelog (v8.1.2...v8.1.6)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
bug #64971 Don't parse external env var values when resolving .env references ( @nicolas-grekas )
Changelog (v8.1.0...v8.1.2)
bug #64386 Don't truncate external env vars containing $ when referenced via ${...} indirection (@nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v8.1.0-BETA2...v8.1.0)
bug #64148 Don't truncate OS env vars containing $ when $_ENV is unpopulated (@HMAZonderland)
Changelog (https://github.com/symfony/dotenv/compare/v8.1.0-BETA1...v8.1.0-BETA2)
bug #64148 Don't truncate OS env vars containing $ when $_ENV is unpopulated (@HMAZonderland)
Changelog (https://github.com/symfony/dotenv/compare/v8.0.11...v8.1.0-BETA1)
Changelog ( v8.0.14...v8.0.15 )
Changelog (v8.0.14...v8.0.15)
Changelog ( v8.0.11...v8.0.14 )
Changelog (v8.0.11...v8.0.14)
bug #64148 Don't truncate OS env vars containing $ when $_ENV is unpopulated (@HMAZonderland)
Changelog (https://github.com/symfony/dotenv/compare/v8.0.9...v8.0.11)
bug #64020 Strip NUL byte placeholder from values passed to putenv() (@alexandre-daubois)
Changelog (https://github.com/symfony/dotenv/compare/v8.0.8...v8.0.9)
putenv() (@alexandre-daubois)bug #63766 Fix preloading warning by replacing anonymous exception class (@pcescon)
Changelog (https://github.com/symfony/dotenv/compare/v8.0.7...v8.0.8)
bug #63496 Defer variable and command expansion to account for overrides from subsequent .env files (@nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v8.0.6...v8.0.7)
bug #63372 Use SYMFONY_DOTENV_PATH variable when dumping dotenv (@Spea)
Changelog (https://github.com/symfony/dotenv/compare/v8.0.5...v8.0.6)
SYMFONY_DOTENV_PATH variable when dumping dotenv (@Spea)Changelog (https://github.com/symfony/dotenv/compare/v8.0.0-RC3...v8.0.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v8.0.0-RC3...v8.0.0)
$defaultName and $defaultDescription properties from DebugCommand command, configuration is done through the #[AsCommand] attributeChangelog (https://github.com/symfony/dotenv/compare/v8.0.0-RC1...v8.0.0-RC2) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v8.0.0-RC1...v8.0.0-RC2)
Changelog (https://github.com/symfony/dotenv/compare/v8.0.0-BETA2...v8.0.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v8.0.0-BETA2...v8.0.0-RC1)
feature symfony/symfony#60776 [Console][FrameworkBundle] Remove deprecated Application::add() methods (@HypeMC)
Changelog (https://github.com/symfony/dotenv/compare/v7.3.4...v8.0.0-BETA1)
Application::add() methods (@HypeMC)Changelog ( v7.4.15...v7.4.18 )
Changelog (v7.4.15...v7.4.18)
Changelog ( v7.4.14...v7.4.15 )
Changelog (v7.4.14...v7.4.15)
bug #64386 Don't truncate external env vars containing $ when referenced via ${...} indirection (@nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v7.4.11...v7.4.14)
bug #64148 Don't truncate OS env vars containing $ when $_ENV is unpopulated (@HMAZonderland)
Changelog (https://github.com/symfony/dotenv/compare/v7.4.9...v7.4.11)
bug #64020 Strip NUL byte placeholder from values passed to putenv() (@alexandre-daubois)
Changelog (https://github.com/symfony/dotenv/compare/v7.4.8...v7.4.9)
putenv() (@alexandre-daubois)bug #63766 Fix preloading warning by replacing anonymous exception class (@pcescon)
Changelog (https://github.com/symfony/dotenv/compare/v7.4.7...v7.4.8)
bug #63496 Defer variable and command expansion to account for overrides from subsequent .env files (@nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v7.4.6...v7.4.7)
bug #63372 Use SYMFONY_DOTENV_PATH variable when dumping dotenv (@Spea)
Changelog (https://github.com/symfony/dotenv/compare/v7.4.5...v7.4.6)
SYMFONY_DOTENV_PATH variable when dumping dotenv (@Spea)Changelog (https://github.com/symfony/dotenv/compare/v7.4.0-RC3...v7.4.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.4.0-RC3...v7.4.0)
Changelog (https://github.com/symfony/dotenv/compare/v7.4.0-RC1...v7.4.0-RC2) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.4.0-RC1...v7.4.0-RC2)
Changelog (https://github.com/symfony/dotenv/compare/v7.4.0-BETA2...v7.4.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.4.0-BETA2...v7.4.0-RC1)
feature symfony/symfony#60394 [Console][FrameworkBundle] Simplify using invokable commands when the component is used standalone (@HypeMC)
Changelog (https://github.com/symfony/dotenv/compare/v7.3.4...v7.4.0-BETA1)
Changelog (https://github.com/symfony/dotenv/compare/v7.3.7...v7.3.8) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.3.7...v7.3.8)
Changelog (https://github.com/symfony/dotenv/compare/v7.3.1...v7.3.2) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.3.1...v7.3.2)
Changelog (https://github.com/symfony/dotenv/compare/v7.3.0-RC1...v7.3.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.3.0-RC1...v7.3.0)
Changelog (https://github.com/symfony/dotenv/compare/v7.3.0-BETA2...v7.3.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.3.0-BETA2...v7.3.0-RC1)
Changelog (https://github.com/symfony/dotenv/compare/v7.2.6...v7.3.0-BETA1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.2.6...v7.3.0-BETA1)
Changelog (https://github.com/symfony/dotenv/compare/v7.2.8...v7.2.9) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.2.8...v7.2.9)
bug symfony/symfony#59007 [Dotenv] read runtime config from composer.json in debug dotenv command (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v7.2.0-RC1...v7.2.0)
Changelog (https://github.com/symfony/dotenv/compare/v7.2.0-BETA2...v7.2.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.2.0-BETA2...v7.2.0-RC1)
Changelog (https://github.com/symfony/dotenv/compare/v7.1.6...v7.2.0-BETA1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.1.6...v7.2.0-BETA1)
bug symfony/symfony#59007 [Dotenv] read runtime config from composer.json in debug dotenv command (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v7.1.8...v7.1.9)
bug symfony/symfony#58393 [Dotenv] Default value can be empty (@HypeMC)
Changelog (https://github.com/symfony/dotenv/compare/v7.1.5...v7.1.6)
bug symfony/symfony#58274 [Dotenv] throw a meaningful exception when parsing dotenv files with BOM (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v7.1.4...v7.1.5)
Changelog (https://github.com/symfony/dotenv/compare/v7.1.2...v7.1.3) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.1.2...v7.1.3)
Changelog (https://github.com/symfony/dotenv/compare/v7.1.0...v7.1.1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.1.0...v7.1.1)
Changelog (https://github.com/symfony/dotenv/compare/v7.1.0-RC1...v7.1.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.1.0-RC1...v7.1.0)
SYMFONY_DOTENV_PATH variable with the path to the .env file loaded by Dotenv::loadEnv() or Dotenv::bootEnv()Changelog (https://github.com/symfony/dotenv/compare/v7.1.0-BETA1...v7.1.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.1.0-BETA1...v7.1.0-RC1)
feature symfony/symfony#52638 [Dotenv] Add SYMFONY_DOTENV_PATH, consumed by debug:dotenv for custom .env path (@GromNaN)
Changelog (https://github.com/symfony/dotenv/compare/v7.0.7...v7.1.0-BETA1)
SYMFONY_DOTENV_PATH, consumed by debug:dotenv for custom .env path (@GromNaN)Changelog (https://github.com/symfony/dotenv/compare/v7.0.9...v7.0.10) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.0.9...v7.0.10)
bug symfony/symfony#54700 [Dotenv] show overridden vars too when running debug:dotenv (@HMRDevil)
Changelog (https://github.com/symfony/dotenv/compare/v7.0.7...v7.0.8)
Changelog (https://github.com/symfony/dotenv/compare/v7.0.6...v7.0.7) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.0.6...v7.0.7)
bug symfony/symfony#53870 [Dotenv] Specify envKey while loading variables with the dotenv:dump (@scruwi)
Changelog (https://github.com/symfony/dotenv/compare/v7.0.3...v7.0.4)
Changelog (https://github.com/symfony/dotenv/compare/v7.0.2...v7.0.3) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.0.2...v7.0.3)
bug symfony/symfony#52928 [Dotenv] Allow environment variables starting with an underscore (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v7.0.1...v7.0.2)
SYMFONY_DOTENV_VARS being the empty string (@xabbuh)Changelog (https://github.com/symfony/dotenv/compare/v7.0.0-RC2...v7.0.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.0.0-RC2...v7.0.0)
Changelog (https://github.com/symfony/dotenv/compare/v7.0.0-BETA3...v7.0.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.0.0-BETA3...v7.0.0-RC1)
Changelog (https://github.com/symfony/dotenv/compare/v7.0.0-BETA1...v7.0.0-BETA2) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v7.0.0-BETA1...v7.0.0-BETA2)
feature symfony/symfony#50613 [Console] Remove deprecations across the component (@alexandre-daubois)
Changelog (https://github.com/symfony/dotenv/compare/v6.3.6...v7.0.0-BETA1)
Changelog ( v6.4.43...v6.4.45 )
Changelog (v6.4.43...v6.4.45)
Changelog ( v6.4.42...v6.4.43 )
Changelog (v6.4.42...v6.4.43)
bug #64386 Don't truncate external env vars containing $ when referenced via ${...} indirection (@nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.39...v6.4.42)
bug #64148 Don't truncate OS env vars containing $ when $_ENV is unpopulated (@HMAZonderland)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.37...v6.4.39)
One column per quarter.