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	}

---

Branches

Below are the source code lines that represent each code branch as identified by Xdebug. Please note a branch is not necessarily coterminous with a line, a line may contain multiple branches and therefore show up more than once. Please also be aware that some branches may be implicit rather than explicit, 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	}