1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celemas\Sire\Coercer;
6
7	use Celemas\Sire\Coercion;
8	use Celemas\Sire\CoercionMode;
9	use Celemas\Sire\Contract;
10	use Celemas\Sire\Failure;
11	use Override;
12
13	/** @api */
14	final class Boolean implements Contract\Coercer
15	{
16	public string $message {
17	get => '{label} must be true or false';
18	}
19
20	#[Override]
21	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
22	{
23	if ($pristine === null) {
24	return new Coercion(null, null, empty: true);
25	}
26
27	if (is_bool($pristine)) {
28	return new Coercion($pristine, $pristine);
29	}
30
31	if ($mode === CoercionMode::Strict) {
32	return self::invalid($pristine);
33	}
34
35	$value = self::toBoolean($pristine);
36
37	return $value === null
38	? self::invalid($pristine)
39	: new Coercion($value, $pristine);
40	}
41
42	private static function invalid(mixed $pristine): Coercion
43	{
44	return new Coercion(
45	$pristine,
46	$pristine,
47	Failure::invalid(),
48	);
49	}
50
51	private static function toBoolean(mixed $value): ?bool
52	{
53	return match (true) {
54	$value === 1 => true,
55	$value === 0 => false,
56	is_string($value) => self::toStringBoolean($value),
57	default => null,
58	};
59	}
60
61	private static function toStringBoolean(string $value): ?bool
62	{
63	return match (strtolower(trim($value))) {
64	'1', 'true', 'on', 'yes' => true,
65	'0', 'false', 'off', 'no' => false,
66	default => null,
67	};
68	}
69	}

---

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.

Boolean->$message::get

17	get => '{label} must be true or false';

Boolean->coerce

21	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
22	{
23	if ($pristine === null) {

24	return new Coercion(null, null, empty: true);

27	if (is_bool($pristine)) {

28	return new Coercion($pristine, $pristine);

31	if ($mode === CoercionMode::Strict) {

32	return self::invalid($pristine);

35	$value = self::toBoolean($pristine);
36
37	return $value === null

38	? self::invalid($pristine)

39	: new Coercion($value, $pristine);

39	: new Coercion($value, $pristine);
40	}

Boolean->invalid

42	private static function invalid(mixed $pristine): Coercion
43	{
44	return new Coercion(
45	$pristine,
46	$pristine,
47	Failure::invalid(),
48	);
49	}

Boolean->toBoolean

51	private static function toBoolean(mixed $value): ?bool
52	{
53	return match (true) {
54	$value === 1 => true,

55	$value === 0 => false,

56	is_string($value) => self::toStringBoolean($value),

56	is_string($value) => self::toStringBoolean($value),

54	$value === 1 => true,

55	$value === 0 => false,

56	is_string($value) => self::toStringBoolean($value),

57	default => null,

57	default => null,
58	};
59	}

Boolean->toStringBoolean

61	private static function toStringBoolean(string $value): ?bool
62	{
63	return match (strtolower(trim($value))) {

63	return match (strtolower(trim($value))) {

63	return match (strtolower(trim($value))) {

63	return match (strtolower(trim($value))) {

64	'1', 'true', 'on', 'yes' => true,

65	'0', 'false', 'off', 'no' => false,

66	default => null,

66	default => null,
67	};
68	}