blob: 820cabfb3a8107b9da1f7af442cb64fbc189aa1e [file] [log] [blame]
Matthias Andreas Benkard7b2a3a12021-08-16 10:57:25 +02001<?php
2
3/*
4 * This file is part of the Symfony package.
5 *
6 * (c) Fabien Potencier <fabien@symfony.com>
7 *
8 * For the full copyright and license information, please view the LICENSE
9 * file that was distributed with this source code.
10 */
11
12namespace Symfony\Component\Translation\Provider;
13
14use Symfony\Component\Translation\Exception\InvalidArgumentException;
15use Symfony\Component\Translation\Exception\MissingRequiredOptionException;
16
17/**
18 * @author Fabien Potencier <fabien@symfony.com>
19 * @author Oskar Stark <oskarstark@googlemail.com>
20 */
21final class Dsn
22{
23 private $scheme;
24 private $host;
25 private $user;
26 private $password;
27 private $port;
28 private $path;
29 private $options;
30 private $originalDsn;
31
32 public function __construct(string $dsn)
33 {
34 $this->originalDsn = $dsn;
35
36 if (false === $parsedDsn = parse_url($dsn)) {
37 throw new InvalidArgumentException(sprintf('The "%s" translation provider DSN is invalid.', $dsn));
38 }
39
40 if (!isset($parsedDsn['scheme'])) {
41 throw new InvalidArgumentException(sprintf('The "%s" translation provider DSN must contain a scheme.', $dsn));
42 }
43 $this->scheme = $parsedDsn['scheme'];
44
45 if (!isset($parsedDsn['host'])) {
46 throw new InvalidArgumentException(sprintf('The "%s" translation provider DSN must contain a host (use "default" by default).', $dsn));
47 }
48 $this->host = $parsedDsn['host'];
49
50 $this->user = '' !== ($parsedDsn['user'] ?? '') ? urldecode($parsedDsn['user']) : null;
51 $this->password = '' !== ($parsedDsn['pass'] ?? '') ? urldecode($parsedDsn['pass']) : null;
52 $this->port = $parsedDsn['port'] ?? null;
53 $this->path = $parsedDsn['path'] ?? null;
54 parse_str($parsedDsn['query'] ?? '', $this->options);
55 }
56
57 public function getScheme(): string
58 {
59 return $this->scheme;
60 }
61
62 public function getHost(): string
63 {
64 return $this->host;
65 }
66
67 public function getUser(): ?string
68 {
69 return $this->user;
70 }
71
72 public function getPassword(): ?string
73 {
74 return $this->password;
75 }
76
77 public function getPort(int $default = null): ?int
78 {
79 return $this->port ?? $default;
80 }
81
82 public function getOption(string $key, $default = null)
83 {
84 return $this->options[$key] ?? $default;
85 }
86
87 public function getRequiredOption(string $key)
88 {
89 if (!\array_key_exists($key, $this->options) || '' === trim($this->options[$key])) {
90 throw new MissingRequiredOptionException($key);
91 }
92
93 return $this->options[$key];
94 }
95
96 public function getOptions(): array
97 {
98 return $this->options;
99 }
100
101 public function getPath(): ?string
102 {
103 return $this->path;
104 }
105
106 public function getOriginalDsn(): string
107 {
108 return $this->originalDsn;
109 }
110}