1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
namespace ValueObjects\Person; |
4
|
|
|
|
5
|
|
|
use ValueObjects\StringLiteral\StringLiteral; |
6
|
|
|
use ValueObjects\Util\Util; |
7
|
|
|
use ValueObjects\ValueObjectInterface; |
8
|
|
|
|
9
|
|
|
class Name implements ValueObjectInterface |
10
|
|
|
{ |
11
|
|
|
/** |
12
|
|
|
* First name |
13
|
|
|
* |
14
|
|
|
* @var \ValueObjects\StringLiteral\StringLiteral |
15
|
|
|
*/ |
16
|
|
|
private $firstName; |
17
|
|
|
|
18
|
|
|
/** |
19
|
|
|
* Middle name |
20
|
|
|
* |
21
|
|
|
* @var \ValueObjects\StringLiteral\StringLiteral |
22
|
|
|
*/ |
23
|
|
|
private $middleName; |
24
|
|
|
|
25
|
|
|
/** |
26
|
|
|
* Last name |
27
|
|
|
* |
28
|
|
|
* @var \ValueObjects\StringLiteral\StringLiteral |
29
|
|
|
*/ |
30
|
|
|
private $lastName; |
31
|
|
|
|
32
|
|
|
/** |
33
|
|
|
* Returns a Name objects form PHP native values |
34
|
|
|
* |
35
|
|
|
* @param string $first_name |
|
|
|
|
36
|
|
|
* @param string $middle_name |
|
|
|
|
37
|
|
|
* @param string $last_name |
|
|
|
|
38
|
|
|
* @return Name |
39
|
|
|
*/ |
40
|
1 |
|
public static function fromNative() |
41
|
|
|
{ |
42
|
1 |
|
$args = func_get_args(); |
43
|
|
|
|
44
|
1 |
|
$firstName = new StringLiteral($args[0]); |
45
|
1 |
|
$middleName = new StringLiteral($args[1]); |
46
|
1 |
|
$lastName = new StringLiteral($args[2]); |
47
|
|
|
|
48
|
1 |
|
return new static($firstName, $middleName, $lastName); |
49
|
|
|
} |
50
|
|
|
|
51
|
|
|
/** |
52
|
|
|
* Returns a Name object |
53
|
|
|
* |
54
|
|
|
* @param StringLiteral $first_name |
55
|
|
|
* @param StringLiteral $middle_name |
56
|
|
|
* @param StringLiteral $last_name |
57
|
|
|
*/ |
58
|
8 |
|
public function __construct(StringLiteral $first_name, StringLiteral $middle_name, StringLiteral $last_name) |
59
|
|
|
{ |
60
|
8 |
|
$this->firstName = $first_name; |
61
|
8 |
|
$this->middleName = $middle_name; |
62
|
8 |
|
$this->lastName = $last_name; |
63
|
8 |
|
} |
64
|
|
|
|
65
|
|
|
/** |
66
|
|
|
* Returns the first name |
67
|
|
|
* |
68
|
|
|
* @return StringLiteral |
69
|
|
|
*/ |
70
|
1 |
|
public function getFirstName() |
71
|
|
|
{ |
72
|
1 |
|
return $this->firstName; |
73
|
|
|
} |
74
|
|
|
|
75
|
|
|
/** |
76
|
|
|
* Returns the middle name |
77
|
|
|
* |
78
|
|
|
* @return StringLiteral |
79
|
|
|
*/ |
80
|
1 |
|
public function getMiddleName() |
81
|
|
|
{ |
82
|
1 |
|
return $this->middleName; |
83
|
|
|
} |
84
|
|
|
|
85
|
|
|
/** |
86
|
|
|
* Returns the last name |
87
|
|
|
* |
88
|
|
|
* @return StringLiteral |
89
|
|
|
*/ |
90
|
1 |
|
public function getLastName() |
91
|
|
|
{ |
92
|
1 |
|
return $this->lastName; |
93
|
|
|
} |
94
|
|
|
|
95
|
|
|
/** |
96
|
|
|
* Returns the full name |
97
|
|
|
* |
98
|
|
|
* @return StringLiteral |
99
|
|
|
*/ |
100
|
5 |
|
public function getFullName() |
101
|
|
|
{ |
102
|
5 |
|
$fullNameString = $this->firstName . |
103
|
5 |
|
($this->middleName->isEmpty() ? '' : ' ' . $this->middleName) . |
104
|
5 |
|
($this->lastName->isEmpty() ? '' : ' ' . $this->lastName); |
105
|
|
|
|
106
|
5 |
|
$fullName = new StringLiteral($fullNameString); |
107
|
|
|
|
108
|
5 |
|
return $fullName; |
109
|
|
|
} |
110
|
|
|
|
111
|
|
|
/** |
112
|
|
|
* Tells whether two names are equal by comparing their values |
113
|
|
|
* |
114
|
|
|
* @param ValueObjectInterface $name |
115
|
|
|
* @return bool |
116
|
|
|
*/ |
117
|
2 |
|
public function sameValueAs(ValueObjectInterface $name) |
118
|
|
|
{ |
119
|
2 |
|
if (false === Util::classEquals($this, $name)) { |
120
|
1 |
|
return false; |
121
|
|
|
} |
122
|
|
|
|
123
|
2 |
|
return $this->getFullName() == $name->getFullName(); |
|
|
|
|
124
|
|
|
} |
125
|
|
|
|
126
|
|
|
/** |
127
|
|
|
* Returns the full name |
128
|
|
|
* |
129
|
|
|
* @return string |
130
|
|
|
*/ |
131
|
1 |
|
public function __toString() |
132
|
|
|
{ |
133
|
1 |
|
return \strval($this->getFullName()); |
134
|
|
|
} |
135
|
|
|
} |
136
|
|
|
|
This check looks for PHPDoc comments describing methods or function parameters that do not exist on the corresponding method or function.
Consider the following example. The parameter
$italy
is not defined by the methodfinale(...)
.The most likely cause is that the parameter was removed, but the annotation was not.