throw a meaningful exception when parsing dotenv files with BOM

xabbuh · xabbuh · commit de314bf6d48d · 2024-09-16T09:16:29.000+02:00
diff --git a/src/Symfony/Component/Dotenv/Dotenv.php b/src/Symfony/Component/Dotenv/Dotenv.php
@@ -568,7 +568,13 @@ private function doLoad(bool $overrideExistingVars, array $paths): void
                 throw new PathException($path);
             }
 
-            $this->populate($this->parse(file_get_contents($path), $path), $overrideExistingVars);
+            $data = file_get_contents($path);
+
+            if ("\xEF\xBB\xBF" === substr($data, 0, 3)) {
+                throw new FormatException('Loading files starting with a byte-order-mark is not supported.', new FormatExceptionContext($data, $path, 1, 0));
+            }
+
+            $this->populate($this->parse($data, $path), $overrideExistingVars);
         }
     }
 }
diff --git a/src/Symfony/Component/Dotenv/Tests/DotenvTest.php b/src/Symfony/Component/Dotenv/Tests/DotenvTest.php
@@ -604,4 +604,14 @@ public function testBootEnv()
         $resetContext();
         rmdir($tmpdir);
     }
+
+    public function testExceptionWithBom()
+    {
+        $dotenv = new Dotenv();
+
+        $this->expectException(FormatException::class);
+        $this->expectExceptionMessage('Loading files starting with a byte-order-mark is not supported.');
+
+        $dotenv->load(__DIR__.'/fixtures/file_with_bom');
+    }
 }
diff --git a/src/Symfony/Component/Dotenv/Tests/fixtures/file_with_bom b/src/Symfony/Component/Dotenv/Tests/fixtures/file_with_bom
@@ -0,0 +1 @@
+﻿FOO=BAR

Original file line number	Diff line number	Diff line change
`@@ -568,7 +568,13 @@ private function doLoad(bool $overrideExistingVars, array $paths): void`
`568`	`568`	`throw new PathException($path);`
`569`	`569`	`}`
`570`	`570`
`571`		`- $this->populate($this->parse(file_get_contents($path), $path), $overrideExistingVars);`
	`571`	`+ $data = file_get_contents($path);`
	`572`	`+`
	`573`	`+ if ("\xEF\xBB\xBF" === substr($data, 0, 3)) {`
	`574`	`+ throw new FormatException('Loading files starting with a byte-order-mark is not supported.', new FormatExceptionContext($data, $path, 1, 0));`
	`575`	`+ }`
	`576`	`+`
	`577`	`+ $this->populate($this->parse($data, $path), $overrideExistingVars);`
`572`	`578`	`}`
`573`	`579`	`}`
`574`	`580`	`}`