1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celemas\Quma\Exception;
6
7	use RuntimeException;
8	use Throwable;
9
10	/** @api */
11	class HydrationFailure extends RuntimeException
12	{
13	/**
14	* @param class-string $class
15	* @param list<string> $rowKeys
16	*/
17	public static function fromHydratableFailure(
18	string $class,
19	?string $sourcePath,
20	array $rowKeys,
21	Throwable $previous,
22	): self {
23	return new self(
24	self::message(
25	$class,
26	$sourcePath,
27	'Hydratable::fromRow() failed. Row keys: ' . self::formatRowKeys($rowKeys) . '.',
28	),
29	0,
30	$previous,
31	);
32	}
33
34	/** @param class-string $class */
35	protected static function message(string $class, ?string $sourcePath, string $detail): string
36	{
37	return "Could not hydrate {$class} from " . self::source($sourcePath) . ": {$detail}";
38	}
39
40	protected static function source(?string $sourcePath): string
41	{
42	return $sourcePath ?? 'ad-hoc SQL';
43	}
44
45	/** @param list<string> $rowKeys */
46	protected static function formatRowKeys(array $rowKeys): string
47	{
48	return $rowKeys === [] ? '(none)' : implode(', ', $rowKeys);
49	}
50
51	protected static function valueType(mixed $value): string
52	{
53	if (is_object($value)) {
54	return $value::class;
55	}
56
57	if (is_resource($value)) {
58	return get_resource_type($value) . ' resource';
59	}
60
61	return get_debug_type($value);
62	}
63	}

---

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.

HydrationFailure->formatRowKeys

46	protected static function formatRowKeys(array $rowKeys): string
47	{
48	return $rowKeys === [] ? '(none)' : implode(', ', $rowKeys);

48	return $rowKeys === [] ? '(none)' : implode(', ', $rowKeys);

48	return $rowKeys === [] ? '(none)' : implode(', ', $rowKeys);

48	return $rowKeys === [] ? '(none)' : implode(', ', $rowKeys);

48	return $rowKeys === [] ? '(none)' : implode(', ', $rowKeys);

48	return $rowKeys === [] ? '(none)' : implode(', ', $rowKeys);

48	return $rowKeys === [] ? '(none)' : implode(', ', $rowKeys);
49	}

HydrationFailure->fromHydratableFailure

18	string $class,
19	?string $sourcePath,
20	array $rowKeys,
21	Throwable $previous,
22	): self {
23	return new self(
24	self::message(
25	$class,
26	$sourcePath,
27	'Hydratable::fromRow() failed. Row keys: ' . self::formatRowKeys($rowKeys) . '.',
28	),
29	0,
30	$previous,
31	);
32	}

HydrationFailure->message

35	protected static function message(string $class, ?string $sourcePath, string $detail): string
36	{
37	return "Could not hydrate {$class} from " . self::source($sourcePath) . ": {$detail}";
38	}

HydrationFailure->source

40	protected static function source(?string $sourcePath): string
41	{
42	return $sourcePath ?? 'ad-hoc SQL';
43	}

HydrationFailure->valueType

51	protected static function valueType(mixed $value): string
52	{
53	if (is_object($value)) {

54	return $value::class;

57	if (is_resource($value)) {

58	return get_resource_type($value) . ' resource';

61	return get_debug_type($value);
62	}