Added support for config.local.php, databases.local.php & settings.local.php files. Added MAILGUN_URL support. Updating change log.

Author: dl-unleashed-technologies

CHANGELOG.md

@@ -4,11 +4,18 @@ Updates should follow the [Keep a CHANGELOG](https://keepachangelog.com/) princi
 
 ## [Unreleased][unreleased]
 
+## [0.1.15] - 2022-01-25
+
+### Changed
+
+- Added support for `config.local.php`, `databases.local.php` & `settings.local.php` files.
+- Added `MAILGUN_URL` support.
+
 ## [0.1.14] - 2022-01-21
 
 ### Changed
 
-- Added TRUSTED_HOST_PATTERNS support.
+- Added `TRUSTED_HOST_PATTERNS` support.
 
 ## [0.1.13] - 2022-01-20
 
@@ -107,7 +114,8 @@ Updates should follow the [Keep a CHANGELOG](https://keepachangelog.com/) princi
 
 **Initial release!**
 
-[unreleased]: https://github.com/unleashedtech/dotenv-drupal/compare/0.1.14...main
+[unreleased]: https://github.com/unleashedtech/dotenv-drupal/compare/0.1.15...main
+[0.1.15]: https://github.com/unleashedtech/dotenv-drupal/compare/0.1.14...0.1.15
 [0.1.14]: https://github.com/unleashedtech/dotenv-drupal/compare/0.1.13...0.1.14
 [0.1.13]: https://github.com/unleashedtech/dotenv-drupal/compare/0.1.12...0.1.13
 [0.1.12]: https://github.com/unleashedtech/dotenv-drupal/compare/0.1.11...0.1.12

README.md

@@ -113,6 +113,7 @@ configuration.
 * [FILE_TEMP_PATH](#file_temp_path)
 * [CONFIG_SYNC_PATH](#config_sync_path)
 * [DOMAINS](#domains)
+* [MAILGUN_URL](#mailgun_url)
 * [SHIELD](#shield)
 * [SHIELD_USERNAME](#shield_username)
 * [SHIELD_PASSWORD](#shield_password)
@@ -178,9 +179,26 @@ A CSV list of domains used by the given environment:
 DOMAINS=foo.example,bar.example,baz.example
 ```
 
+#### MAILGUN_URL
+The information Drupal should use to authenticate with the Mailgun API.
+
+The "user" in the [DSN](https://en.wikipedia.org/wiki/Data_source_name) is the API key.
+
+##### US URL Example
+```dotenv
+MAILGUN_URL=https://[email protected]
+```
+
+##### EU URL Example
+```dotenv
+MAILGUN_URL=https://[email protected]
+```
+
 #### SHIELD
 A boolean allowing the enabling/disabling of Shield module auth functionality.
 
+Note: _Make sure the "Enable Shield" checkbox is checked in Drupal & that config is committed._
+
 ##### SHIELD_USERNAME
 The username for Shield to require, if enabled.
 

src/Dotenv.php

@@ -88,17 +88,17 @@ private function alter(&$data, $type): void
         $$type = &$data;
 
         // Allow alteration via the `default` directory.
-        $file = DRUPAL_ROOT . '/sites/default/' .
-            $type . '.' . $this->getEnvironmentName() . '.php';
-        if (file_exists($file)) {
-            include $file;
-        }
+        $files[] = DRUPAL_ROOT . '/sites/default/' . $type . '.' . $this->getEnvironmentName() . '.php';
+        $files[] = DRUPAL_ROOT . '/sites/default/' . $type . '.local.php';
 
         // Allow alteration via non-`default` directories.
         $siteName = $this->getSiteName();
         if ($siteName !== 'default') {
-            $file = DRUPAL_ROOT . '/sites/' . $siteName . '/' .
-                $type . '.' . $this->getEnvironmentName() . '.php';
+            $files[] = DRUPAL_ROOT . '/sites/' . $siteName . '/' . $type . '.' . $this->getEnvironmentName() . '.php';
+            $files[] = DRUPAL_ROOT . '/sites/' . $siteName . '/' . $type . '.local.php';
+        }
+
+        foreach ($files as $file) {
             if (file_exists($file)) {
                 include $file;
             }
@@ -159,6 +159,16 @@ public function getConfig(): array
                 break;
         }
 
+        // Configure Mailgun.
+        if (isset($_SERVER['MAILGUN_URL'])) {
+            $parts = parse_url($_SERVER['MAILGUN_URL']);
+            $config['mailgun.settings']['api_endpoint'] = vsprintf('%s://%s', [
+                'scheme' => $parts['scheme'] ?? 'https',
+                'host' => $parts['host'] ?? 'api.mailgun.net',
+            ]);
+            $config['mailgun.settings']['api_key'] = $parts['name'] ?? 'key-1234567890abcdefghijklmnopqrstu';
+        }
+
         // Configure Shield if enabled.
         if ($config['shield.settings']['shield_enable']) {
             if (isset($_SERVER['SHIELD_USERNAME'])) {