symfony · Nyholm · May 8, 2020 · May 28, 2020 · May 29, 2020 · May 29, 2020
diff --git a/src/Symfony/Component/Dsn/.gitattributes b/src/Symfony/Component/Dsn/.gitattributes
@@ -0,0 +1,4 @@
+/Tests export-ignore
+/phpunit.xml.dist export-ignore
+/.gitattributes export-ignore
+/.gitignore export-ignore
diff --git a/src/Symfony/Component/Dsn/.gitignore b/src/Symfony/Component/Dsn/.gitignore
@@ -0,0 +1,3 @@
+vendor/
+composer.lock
+phpunit.xml
diff --git a/src/Symfony/Component/Dsn/CHANGELOG.md b/src/Symfony/Component/Dsn/CHANGELOG.md
@@ -0,0 +1,3 @@
+CHANGELOG
+=========
+
diff --git a/src/Symfony/Component/Dsn/Configuration/Dsn.php b/src/Symfony/Component/Dsn/Configuration/Dsn.php
@@ -0,0 +1,87 @@
+<?php
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Dsn\Configuration;
+
+/**
+ * Base DSN object.
+ *
+ * Example:
+ * - null://
+ * - redis:?host[h1]&host[h2]&host[/foo:]
+ *
+ * @author Tobias Nyholm <tobias.nyholm@gmail.com>
+ */
+class Dsn
+{
+    /**
+     * @var string|null
+     */
+    private $scheme;
+
+    /**
+     * @var array
+     */
+    private $parameters = [];
+
+    public function __construct(?string $scheme, array $parameters = [])
+    {
+        $this->scheme = $scheme;
+        $this->parameters = $parameters;
+    }
+
+    public function getScheme(): ?string
+    {
+        return $this->scheme;
+    }
+
+    public function getParameters(): array
+    {
+        return $this->parameters;
+    }
+
+    public function getParameter(string $key, $default = null)
+    {
+        return \array_key_exists($key, $this->parameters) ? $this->parameters[$key] : $default;
+    }
+
+    public function getHost(): ?string
+    {
+        return null;
+    }
+
+    public function getPort(): ?int
+    {
+        return null;
+    }
+
+    public function getPath(): ?string
+    {
+        return null;
+    }
+
+    public function getUser(): ?string
+    {
+        return null;
+    }
+
+    public function getPassword(): ?string
+    {
+        return null;
+    }
+
+    /**
+     * @var string
+     */
+    public function __toString()
+    {
+        return sprintf('%s://%s', $this->getScheme(), empty($this->parameters) ? '' : '?'.http_build_query($this->parameters));
+    }
+}
diff --git a/src/Symfony/Component/Dsn/Configuration/DsnFunction.php b/src/Symfony/Component/Dsn/Configuration/DsnFunction.php
@@ -0,0 +1,89 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Symfony\Component\Dsn\Configuration;
+
+/**
+ * A function with one or more arguments. The default function is called "dsn".
+ * Other function may be "failover" or "roundrobin".
+ *
+ * Examples:
+ * - failover(redis://localhost memcached://example.com)
+ * - dsn(amqp://guest:password@localhost:1234)
+ * - foobar(amqp://guest:password@localhost:1234 amqp://localhost)?delay=10
+ *
+ * @author Tobias Nyholm <tobias.nyholm@gmail.com>
+ */
+class DsnFunction
+{
+    /**
+     * @var string
+     */
+    private $name;
+
+    /**
+     * @var array
+     */
+    private $arguments;
+
+    /**
+     * @var array
+     */
+    private $parameters;
+
+    public function __construct(string $name, array $arguments, array $parameters = [])
+    {
+        $this->name = $name;
+        $this->arguments = $arguments;
+        $this->parameters = $parameters;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * @return array<DsnFunction|Dsn>
+     */
+    public function getArguments(): array
+    {
+        return $this->arguments;
+    }
+
+    public function getParameters(): array
+    {
+        return $this->parameters;
+    }
+
+    public function getParameter(string $key, $default = null)
+    {
+        return \array_key_exists($key, $this->parameters) ? $this->parameters[$key] : $default;
+    }
+
+    /**
+     * @return DsnFunction|Dsn
+     */
+    public function first()
+    {
+        return reset($this->arguments);
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString()
+    {
+        return sprintf('%s(%s)%s', $this->getName(), implode(' ', $this->getArguments()), empty($this->parameters) ? '' : '?'.http_build_query($this->parameters));
+    }
+}
diff --git a/src/Symfony/Component/Dsn/Configuration/Path.php b/src/Symfony/Component/Dsn/Configuration/Path.php
@@ -0,0 +1,63 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Symfony\Component\Dsn\Configuration;
+
+/**
+ * A "path like" DSN string.
+ *
+ * Example:
+ * - redis:///var/run/redis/redis.sock
+ * - memcached://user:password@/var/local/run/memcached.socket?weight=25
+ *
+ * @author Tobias Nyholm <tobias.nyholm@gmail.com>
+ */
+class Path extends Dsn
+{
+    use UserPasswordTrait;
+    /**
+     * @var string
+     */
+    private $path;
+
+    public function __construct(string $scheme, string $path, array $parameters = [], array $authentication = [])
+    {
+        $this->path = $path;
+        $this->setAuthentication($authentication);
+        parent::__construct($scheme, $parameters);
+    }
+
+    public function getScheme(): string
+    {
+        return parent::getScheme();
+    }
+
+    public function getPath(): string
+    {
+        return $this->path;
+    }
+
+    /**
+     * @var string
+     */
+    public function __toString()
+    {
+        $parameters = $this->getParameters();
+
+        return
+            $this->getScheme().'://'.
+            $this->getUserInfoString().
+            $this->getPath().
+            (empty($parameters) ? '' : '?'.http_build_query($parameters));
+    }
+}
diff --git a/src/Symfony/Component/Dsn/Configuration/Url.php b/src/Symfony/Component/Dsn/Configuration/Url.php
@@ -0,0 +1,85 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Symfony\Component\Dsn\Configuration;
+
+/**
+ * A "URL like" DSN string.
+ *
+ * Example:
+ * - memcached://user:password@127.0.0.1?weight=50
+ * - 127.0.0.1:80
+ * - amqp://127.0.0.1/%2f/messages
+ *
+ * @author Tobias Nyholm <tobias.nyholm@gmail.com>
+ */
+class Url extends Dsn
+{
+    use UserPasswordTrait;
+
+    /**
+     * @var string
+     */
+    private $host;
+
+    /**
+     * @var int|null
+     */
+    private $port;
+
+    /**
+     * @var string|null
+     */
+    private $path;
+
+    public function __construct(?string $scheme, string $host, ?int $port = null, ?string $path = null, array $parameters = [], array $authentication = [])
+    {
+        $this->host = $host;
+        $this->port = $port;
+        $this->path = $path;
+        $this->setAuthentication($authentication);
+        parent::__construct($scheme, $parameters);
+    }
+
+    public function getHost(): string
+    {
+        return $this->host;
+    }
+
+    public function getPort(): ?int
+    {
+        return $this->port;
+    }
+
+    public function getPath(): ?string
+    {
+        return $this->path;
+    }
+
+    /**
+     * @var string
+     */
+    public function __toString()
+    {
+        $parameters = $this->getParameters();
+        $scheme = $this->getScheme();
+
+        return
+            (empty($scheme) ? '' : $scheme.'://').
+            $this->getUserInfoString().
+            $this->getHost().
+            (empty($this->port) ? '' : ':'.$this->port).
+            ($this->getPath() ?? '').
+            (empty($parameters) ? '' : '?'.http_build_query($parameters));
+    }
+}