first commit

libraries/vendor/joomla/registry/src/Factory.php

@@ -0,0 +1,57 @@
+<?php
+
+/**
+ * Part of the Joomla Framework Registry Package
+ *
+ * @copyright  Copyright (C) 2015 Open Source Matters, Inc.
+ * @license    GNU General Public License version 2 or later; see LICENSE
+ */
+
+namespace Joomla\Registry;
+
+/**
+ * Factory class to fetch Registry objects
+ *
+ * @since  1.5.0
+ */
+class Factory
+{
+    /**
+     * Returns a FormatInterface object, only creating it if it doesn't already exist.
+     *
+     * @param  string  $type     The format to load
+     * @param  array   $options  Additional options to configure the object
+     *
+     * @return  FormatInterface  Registry format handler
+     *
+     * @throws  \InvalidArgumentException
+     *
+     * @since   1.5.0
+     * @since   2.0.0  Object caching is no longer supported. `Factory::getFormat()` returns a new `FormatInterface`
+     *          instance on each call.
+     */
+    public static function getFormat($type, array $options = [])
+    {
+        // Sanitize format type.
+        $type = \strtolower(\preg_replace('/[^A-Z\d_]/i', '', $type));
+
+        $localNamespace = __NAMESPACE__ . '\\Format';
+        $namespace      = $options['format_namespace'] ?? $localNamespace;
+        $class          = $namespace . '\\' . \ucfirst($type);
+
+        if (!\class_exists($class)) {
+            // Were we given a custom namespace?  If not, there's nothing else we can do
+            if ($namespace === $localNamespace) {
+                throw new \InvalidArgumentException(\sprintf('Unable to load format class for type "%s".', $type), 500);
+            }
+
+            $class = $localNamespace . '\\' . \ucfirst($type);
+
+            if (!\class_exists($class)) {
+                throw new \InvalidArgumentException(\sprintf('Unable to load format class for type "%s".', $type), 500);
+            }
+        }
+
+        return new $class();
+    }
+}