2.0 RC 1 - new ConfigurationService (#3810)

* use html5 email validation
* remove static cache seed, for compatibility with non default (file based) caches
* added caching ConfigurationService, removed use of doctrine result cache
* simplify configuration API

src/Configuration/ConfigLoaderInterface.php

@@ -9,18 +9,13 @@
 
 namespace App\Configuration;
 
-use App\Entity\Configuration;
-
+/**
+ * @internal
+ */
 interface ConfigLoaderInterface
 {
     /**
-     * @param string $name
-     * @return ?Configuration
-     */
-    public function getConfiguration(string $name): ?Configuration;
-
-    /**
-     * @return Configuration[]
+     * @return array<string, string|null>
      */
     public function getConfigurations(): array;
 }

src/Configuration/ConfigurationService.php

@@ -0,0 +1,72 @@
+<?php
+
+/*
+ * This file is part of the Kimai time-tracking app.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace App\Configuration;
+
+use App\Entity\Configuration;
+use App\Form\Model\SystemConfiguration;
+use App\Repository\ConfigurationRepository;
+use Symfony\Contracts\Cache\CacheInterface;
+use Symfony\Contracts\Cache\ItemInterface;
+
+final class ConfigurationService implements ConfigLoaderInterface
+{
+    /**
+     * @var array<string, string|null>
+     */
+    private static array $cacheAll = [];
+    private static bool $initialized = false;
+
+    public function __construct(private ConfigurationRepository $configurationRepository, private CacheInterface $cache)
+    {
+    }
+
+    /**
+     * @return array<string, string|null>
+     */
+    public function getConfigurations(): array
+    {
+        if (self::$initialized === true) {
+            return self::$cacheAll;
+        }
+
+        self::$cacheAll = $this->cache->get('configurations', function (ItemInterface $item) {
+            $item->expiresAfter(86400); // one day
+
+            return $this->configurationRepository->getConfigurations();
+        });
+
+        self::$initialized = true;
+
+        return self::$cacheAll;
+    }
+
+    public function getConfiguration(string $name): ?Configuration
+    {
+        return $this->configurationRepository->findOneBy(['name' => $name]);
+    }
+
+    public function clearCache(): void
+    {
+        $this->cache->delete('configurations');
+        self::$initialized = false;
+    }
+
+    public function saveConfiguration(Configuration $configuration): void
+    {
+        $this->configurationRepository->saveConfiguration($configuration);
+        $this->clearCache();
+    }
+
+    public function saveSystemConfiguration(SystemConfiguration $model): void
+    {
+        $this->configurationRepository->saveSystemConfiguration($model);
+        $this->clearCache();
+    }
+}

src/Configuration/SystemConfiguration.php

@@ -13,7 +13,7 @@ final class SystemConfiguration
 {
     private bool $initialized = false;
 
-    public function __construct(private ConfigLoaderInterface $repository, private ?array $settings)
+    public function __construct(private ConfigLoaderInterface $repository, private array $settings = [])
     {
     }
 
@@ -23,8 +23,8 @@ final class SystemConfiguration
             return;
         }
 
-        foreach ($this->repository->getConfigurations() as $configuration) {
-            $this->set($configuration->getName(), $configuration->getValue());
+        foreach ($this->repository->getConfigurations() as $key => $value) {
+            $this->set($key, $value);
         }
 
         $this->initialized = true;
@@ -35,7 +35,6 @@ final class SystemConfiguration
      *
      * If no key is given to the method, the entire array will be replaced.
      *
-     * @see https://github.com/divineomega/array_undot
      * @param string $key
      * @param mixed $value
      * @return void
@@ -70,6 +69,7 @@ final class SystemConfiguration
     /**
      * This method should be avoided if possible, use plain keys instead.
      *
+     * @see https://github.com/divineomega/array_undot
      * @param string $key
      * @return array
      */
@@ -219,7 +219,7 @@ final class SystemConfiguration
     }
 
     /**
-     * @return array<mixed>
+     * @return array<int, array<'saml'|'kimai', string>>
      */
     public function getSamlRolesMapping(): array
     {
@@ -227,7 +227,7 @@ final class SystemConfiguration
     }
 
     /**
-     * @return array<mixed>
+     * @return array<string, array<mixed>|bool>
      */
     public function getSamlConnection(): array
     {
@@ -235,7 +235,7 @@ final class SystemConfiguration
     }
 
     /**
-     * @return array<mixed>
+     * @return array<int, array<'saml'|'kimai', string>>
      */
     public function getSamlAttributeMapping(): array
     {