1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celemas\Quma;
6
7	use PDO;
8
9	/** @api */
10	final class PdoConfig
11	{
12	private const array DEFAULT_OPTIONS = [
13	PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL,
14	PDO::ATTR_EMULATE_PREPARES => true,
15	PDO::ATTR_CASE => PDO::CASE_NATURAL,
16	];
17	private const array REQUIRED_OPTIONS = [
18	PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
19	];
20
21	/** @param array<array-key, mixed> $options */
22	public function __construct(
23	public readonly ?string $username = null,
24	#[\SensitiveParameter]
25	public readonly ?string $password = null,
26	public readonly array $options = [],
27	public readonly int $fetchMode = PDO::FETCH_ASSOC,
28	) {}
29
30	public function credentials(
31	string $username,
32	#[\SensitiveParameter]
33	?string $password = null,
34	): self {
35	return new self($username, $password, $this->options, $this->fetchMode);
36	}
37
38	/** @param array<array-key, mixed> $options */
39	public function options(array $options): self
40	{
41	return new self($this->username, $this->password, $options, $this->fetchMode);
42	}
43
44	public function option(int $attribute, mixed $value): self
45	{
46	/** @var array<array-key, mixed> $options */
47	$options = array_replace($this->options, [$attribute => $value]);
48
49	return new self($this->username, $this->password, $options, $this->fetchMode);
50	}
51
52	public function fetch(int $fetchMode): self
53	{
54	return new self($this->username, $this->password, $this->options, $fetchMode);
55	}
56
57	/** @return array<array-key, mixed> */
58	public function effectiveOptions(): array
59	{
60	return array_replace(self::DEFAULT_OPTIONS, $this->options, self::REQUIRED_OPTIONS);
61	}
62	}

---

Paths

Below are the source code lines that represent each code path as identified by Xdebug. Please note a path is not necessarily coterminous with a line, a line may contain multiple paths and therefore show up more than once. Please also be aware that some paths may include implicit rather than explicit branches, e.g. an if statement always has an else as part of its logical flow even if you didn't write one.

PdoConfig->effectiveOptions

60	return array_replace(self::DEFAULT_OPTIONS, $this->options, self::REQUIRED_OPTIONS);
61	}

PdoConfig->fetch

52	public function fetch(int $fetchMode): self
53	{
54	return new self($this->username, $this->password, $this->options, $fetchMode);
55	}

PdoConfig->option

44	public function option(int $attribute, mixed $value): self
45	{
46	/** @var array<array-key, mixed> $options */
47	$options = array_replace($this->options, [$attribute => $value]);
48
49	return new self($this->username, $this->password, $options, $this->fetchMode);
50	}

PdoConfig->options

39	public function options(array $options): self
40	{
41	return new self($this->username, $this->password, $options, $this->fetchMode);
42	}