Backport Dotenv::parse()

Author: GrahamCampbell

src/Dotenv.php

@@ -5,10 +5,12 @@
 use Dotenv\Exception\InvalidPathException;
 use Dotenv\Loader\Loader;
 use Dotenv\Loader\LoaderInterface;
+use Dotenv\Repository\Adapter\ArrayAdapter;
 use Dotenv\Repository\RepositoryBuilder;
 use Dotenv\Repository\RepositoryInterface;
 use Dotenv\Store\FileStore;
 use Dotenv\Store\StoreBuilder;
+use Dotenv\Store\StringStore;
 
 class Dotenv
 {
@@ -102,6 +104,47 @@ public static function createImmutable($paths, $names = null, $shortCircuit = tr
         return self::create($repository, $paths, $names, $shortCircuit);
     }
 
+    /**
+     * Create a new dotenv instance with an array backed repository.
+     *
+     * @param string|string[]      $paths
+     * @param string|string[]|null $names
+     * @param bool                 $shortCircuit
+     *
+     * @return \Dotenv\Dotenv
+     */
+    public static function createArrayBacked($paths, $names = null, $shortCircuit = true)
+    {
+        $adapter = new ArrayAdapter();
+
+        $repository = RepositoryBuilder::create()->withReaders([$adapter])->withWriters([$adapter])->make();
+
+        return self::create($repository, $paths, $names, $shortCircuit);
+    }
+
+    /**
+     * Parse the given content and resolve nested variables.
+     *
+     * This method behaves just like load(), only without mutating your actual
+     * environment. We do this by using an array backed repository.
+     *
+     * @param string $content
+     *
+     * @throws \Dotenv\Exception\InvalidFileException
+     *
+     * @return array<string,string|null>
+     */
+    public static function parse($content)
+    {
+        $adapter = new ArrayAdapter();
+
+        $repository = RepositoryBuilder::create()->withReaders([$adapter])->withWriters([$adapter])->make();
+
+        $phpdotenv = new self(new Loader(), $repository, new StringStore($content));
+
+        return $phpdotenv->load();
+    }
+
     /**
      * Read and load environment file(s).
      *

src/Store/StringStore.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Dotenv\Store;
+
+final class StringStore implements StoreInterface
+{
+    /**
+     * The file content.
+     *
+     * @var string
+     */
+    private $content;
+
+    /**
+     * Create a new string store instance.
+     *
+     * @param string $content
+     *
+     * @return void
+     */
+    public function __construct($content)
+    {
+        $this->content = $content;
+    }
+
+    /**
+     * Read the content of the environment file(s).
+     *
+     * @return string
+     */
+    public function read()
+    {
+        return $this->content;
+    }
+}

tests/Dotenv/DotenvTest.php

@@ -308,4 +308,31 @@ public function testLatestConstructor()
             'NULL'   => '',
         ], $dotenv->load());
     }
+
+    public function testDotenvParseExample1()
+    {
+        $output = Dotenv::parse(
+            "BASE_DIR=\"/var/webroot/project-root\"\nCACHE_DIR=\"\${BASE_DIR}/cache\"\nTMP_DIR=\"\${BASE_DIR}/tmp\"\n"
+        );
+
+        self::assertSame($output, [
+            'BASE_DIR'  => '/var/webroot/project-root',
+            'CACHE_DIR' => '/var/webroot/project-root/cache',
+            'TMP_DIR'   => '/var/webroot/project-root/tmp',
+        ]);
+    }
+
+    public function testDotenvParseExample2()
+    {
+        $output = Dotenv::parse("FOO=Bar\nBAZ=\"Hello \${FOO}\"");
+
+        self::assertSame($output, ['FOO' => 'Bar', 'BAZ' => 'Hello Bar']);
+    }
+
+    public function testDotenvParseEmptyCase()
+    {
+        $output = Dotenv::parse('');
+
+        self::assertSame($output, []);
+    }
 }