NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #242 most downloaded on Packagist
Registers environment variables from a .env file
Latest stable
v8.1.6
Last release 29 days 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.
bug #64020 Strip NUL byte placeholder from values passed to putenv() (@alexandre-daubois)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.36...v6.4.37)
putenv() (@alexandre-daubois)bug #63766 Fix preloading warning by replacing anonymous exception class (@pcescon)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.35...v6.4.36)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
bug #63496 Defer variable and command expansion to account for overrides from subsequent .env files (@nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.34...v6.4.35)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.29...v6.4.30) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.4.29...v6.4.30)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.23...v6.4.24) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.4.23...v6.4.24)
bug symfony/symfony#59007 [Dotenv] read runtime config from composer.json in debug dotenv command (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.15...v6.4.16)
bug symfony/symfony#58393 [Dotenv] Default value can be empty (@HypeMC)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.12...v6.4.13)
bug symfony/symfony#58274 [Dotenv] throw a meaningful exception when parsing dotenv files with BOM (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.11...v6.4.12)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.9...v6.4.10) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.4.9...v6.4.10)
bug symfony/symfony#54700 [Dotenv] show overridden vars too when running debug:dotenv (@HMRDevil)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.7...v6.4.8)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.6...v6.4.7) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.4.6...v6.4.7)
bug symfony/symfony#53870 [Dotenv] Specify envKey while loading variables with the dotenv:dump (@scruwi)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.3...v6.4.4)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.2...v6.4.3) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.4.2...v6.4.3)
bug symfony/symfony#52928 [Dotenv] Allow environment variables starting with an underscore (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.1...v6.4.2)
SYMFONY_DOTENV_VARS being the empty string (@xabbuh)Changelog (https://github.com/symfony/dotenv/compare/v6.4.0-RC2...v6.4.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.4.0-RC2...v6.4.0)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.0-BETA3...v6.4.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.4.0-BETA3...v6.4.0-RC1)
Changelog (https://github.com/symfony/dotenv/compare/v6.4.0-BETA1...v6.4.0-BETA2) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.4.0-BETA1...v6.4.0-BETA2)
Changelog (https://github.com/symfony/dotenv/compare/v6.3.6...v6.4.0-BETA1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.3.6...v6.4.0-BETA1)
Changelog (https://github.com/symfony/dotenv/compare/v6.3.11...v6.3.12) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.3.11...v6.3.12)
bug symfony/symfony#52928 [Dotenv] Allow environment variables starting with an underscore (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v6.3.10...v6.3.11)
SYMFONY_DOTENV_VARS being the empty string (@xabbuh)Changelog (https://github.com/symfony/dotenv/compare/v6.3.6...v6.3.7) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.3.6...v6.3.7)
Changelog (https://github.com/symfony/dotenv/compare/v6.3.0-RC2...v6.3.0) *
Changelog (https://github.com/symfony/dotenv/compare/v6.3.0-RC2...v6.3.0)
feature symfony/symfony#49293 [DoctrineBridge] Allow to ignore specific nullable fields in UniqueEntity (@VincentLanglet)
Changelog (https://github.com/symfony/dotenv/compare/v6.3.0-BETA3...v6.3.0-RC1)
isRetryable decision of the retry strategy for re-delivery (@FlyingDR)feature symfony/symfony#49642 [DependencyInjection] Deprecate #[MapDecorated] in favor of #[AutowireDecorated] (@nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v6.2.10...v6.3.0-BETA1)
TriggerInterface extend \Stringable (@kbond)placeholder_attr option (@elementaire)exclude option to the Cascade constraint (@alexandre-daubois)#[MapDecorated] in favor of #[AutowireDecorated] (@nicolas-grekas)TransportNamesStamp (@alexandre-daubois)enum expression function (@alexandre-daubois)notifier.logger_notification_listener to notifier.notification_logger_listener (@ker0x)extra attribute for HttpClient Configuration (@voodooism)#[WithLogLevel] for setting custom log level for exceptions (@angelov)TaggedIteratorArgument (@chalasr)Changelog (https://github.com/symfony/dotenv/compare/v6.2.7...v6.2.8) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.2.7...v6.2.8)
bug #49249 Fix phpdoc Dotenv (alamirault)
Changelog (https://github.com/symfony/dotenv/compare/v6.2.6...v6.2.7)
Changelog (https://github.com/symfony/dotenv/compare/v6.2.4...v6.2.5) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.2.4...v6.2.5)
Changelog (https://github.com/symfony/dotenv/compare/v6.2.0-RC2...v6.2.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.2.0-RC2...v6.2.0)
filter argument to debug:dotenv command to filter variable namesChangelog (https://github.com/symfony/dotenv/compare/v6.2.0-BETA3...v6.2.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.2.0-BETA3...v6.2.0-RC1)
feature #46502 Variable filter added to debug command (rmikalkenas)
Changelog (https://github.com/symfony/dotenv/compare/v6.1.6...v6.2.0-BETA1)
Nothing published for this version
Changelog (https://github.com/symfony/dotenv/compare/v6.1.0-RC1...v6.1.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.1.0-RC1...v6.1.0)
Changelog (https://github.com/symfony/dotenv/compare/v6.1.0-BETA2...v6.1.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.1.0-BETA2...v6.1.0-RC1)
feature #45361 Deprecate the $defaultName property (derrabus)
Changelog (https://github.com/symfony/dotenv/compare/v6.0.7...v6.1.0-BETA1)
$defaultName property (derrabus)Changelog (https://github.com/symfony/dotenv/compare/v6.0.18...v6.0.19) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.0.18...v6.0.19)
bug #45430 Fix reading config for symfony/runtime when running dump command (nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v6.0.4...v6.0.5)
bug #45188 Fix bootEnv() override with .env.local.php when the env key already exists (fancyweb)
Changelog (https://github.com/symfony/dotenv/compare/v6.0.2...v6.0.3)
Changelog (https://github.com/symfony/dotenv/compare/v6.0.1...v6.0.2) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.0.1...v6.0.2)
bug #44494 Remove FQCN type hints on properties (fabpot)
Changelog (https://github.com/symfony/dotenv/compare/v6.0.0...v6.0.1)
Changelog (https://github.com/symfony/dotenv/compare/v6.0.0-RC1...v6.0.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.0.0-RC1...v6.0.0)
Changelog (https://github.com/symfony/dotenv/compare/v6.0.0-BETA3...v6.0.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v6.0.0-BETA3...v6.0.0-RC1)
feature #41357 Remove deprecated code (malteschlueter)
Changelog (https://github.com/symfony/dotenv/compare/v5.3.10...v6.0.0-BETA1)
Changelog ( v5.4.48...v5.4.54 )
Changelog (v5.4.48...v5.4.54)
[SECURITY] Security release
bug symfony/symfony#59007 [Dotenv] read runtime config from composer.json in debug dotenv command (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.47...v5.4.48)
bug symfony/symfony#58393 [Dotenv] Default value can be empty (@HypeMC)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.44...v5.4.45)
bug symfony/symfony#58274 [Dotenv] throw a meaningful exception when parsing dotenv files with BOM (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.43...v5.4.44)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.41...v5.4.42) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.41...v5.4.42)
bug symfony/symfony#54700 [Dotenv] show overridden vars too when running debug:dotenv (@HMRDevil)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.39...v5.4.40)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.38...v5.4.39) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.38...v5.4.39)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.34...v5.4.35) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.34...v5.4.35)
bug symfony/symfony#52928 [Dotenv] Allow environment variables starting with an underscore (@xabbuh)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.33...v5.4.34)
SYMFONY_DOTENV_VARS being the empty string (@xabbuh)Changelog (https://github.com/symfony/dotenv/compare/v5.4.29...v5.4.30) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.29...v5.4.30)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.21...v5.4.22) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.21...v5.4.22)
bug #49249 Fix phpdoc Dotenv (alamirault)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.20...v5.4.21)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.18...v5.4.19) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.18...v5.4.19)
bug #45430 Fix reading config for symfony/runtime when running dump command (nicolas-grekas)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.4...v5.4.5)
bug #45188 Fix bootEnv() override with .env.local.php when the env key already exists (fancyweb)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.2...v5.4.3)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.1...v5.4.2) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.1...v5.4.2)
Changelog (https://github.com/symfony/dotenv/compare/v5.4.0-RC1...v5.4.0) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.0-RC1...v5.4.0)
dotenv:dump command to compile the contents of the .env files into a PHP-optimized file called .env.local.phpdebug:dotenv command to list all dotenv files with variables and values$overrideExistingVars on Dotenv::bootEnv() and Dotenv::loadEnv()Changelog (https://github.com/symfony/dotenv/compare/v5.4.0-BETA3...v5.4.0-RC1) * no significant changes
Changelog (https://github.com/symfony/dotenv/compare/v5.4.0-BETA3...v5.4.0-RC1)
One column per quarter.