|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
namespace luya\validators; |
|
4
|
|
|
|
|
5
|
|
|
use libphonenumber\NumberParseException; |
|
6
|
|
|
use libphonenumber\PhoneNumberFormat; |
|
7
|
|
|
use libphonenumber\PhoneNumberType; |
|
8
|
|
|
use libphonenumber\PhoneNumberUtil; |
|
9
|
|
|
use Yii; |
|
10
|
|
|
use yii\validators\Validator; |
|
11
|
|
|
|
|
12
|
|
|
/** |
|
13
|
|
|
* Phone Number Validator. |
|
14
|
|
|
* |
|
15
|
|
|
* Validates a given phone number, and converts into standardized format by default. See {{PhoneNumberValidator::$autoFormat}} |
|
16
|
|
|
* |
|
17
|
|
|
* @see https://github.com/giggsey/libphonenumber-for-php This library is used to parse, format and validate. |
|
18
|
|
|
* @author Basil Suter <[email protected]> |
|
19
|
|
|
* @since 1.0.25 |
|
20
|
|
|
*/ |
|
21
|
|
|
class PhoneNumberValidator extends Validator |
|
22
|
|
|
{ |
|
23
|
|
|
/** |
|
24
|
|
|
* @var string If a phone number does not contain the country prefix (+41 f.e), define a default country format which then defines the |
|
25
|
|
|
* country prefix. |
|
26
|
|
|
* |
|
27
|
|
|
* ```php |
|
28
|
|
|
* 'country' => 'CH', |
|
29
|
|
|
* ``` |
|
30
|
|
|
*/ |
|
31
|
|
|
public $country; |
|
32
|
|
|
|
|
33
|
|
|
/** |
|
34
|
|
|
* @var boolean Whether the phone number value should be standardized with formating function and write back to the model. This is usefull |
|
35
|
|
|
* in order to have all phone numbers save in the correct format in the database. |
|
36
|
|
|
*/ |
|
37
|
|
|
public $autoFormat = true; |
|
38
|
|
|
|
|
39
|
|
|
/** |
|
40
|
|
|
* @var inter The format which should be taken to auto format the phone number value. |
|
41
|
|
|
*/ |
|
42
|
|
|
public $autoFormatFormat = PhoneNumberFormat::E164; |
|
43
|
|
|
|
|
44
|
|
|
/** |
|
45
|
|
|
* @var integer If enabled, the validator will check the type of number. This can be usefull to test for mobile phone numbers. |
|
46
|
|
|
* |
|
47
|
|
|
* An example to check for mobile phone numbers: |
|
48
|
|
|
* |
|
49
|
|
|
* ```php |
|
50
|
|
|
* 'type' => \libphonenumber\PhoneNumberType::MOBILE |
|
51
|
|
|
* ``` |
|
52
|
|
|
*/ |
|
53
|
|
|
public $type; |
|
54
|
|
|
|
|
55
|
|
|
/** |
|
56
|
|
|
* {@inheritDoc} |
|
57
|
|
|
*/ |
|
58
|
|
|
public function validateAttribute($model, $attribute) |
|
59
|
|
|
{ |
|
60
|
|
|
$phoneUtil = PhoneNumberUtil::getInstance(); |
|
61
|
|
|
|
|
62
|
|
|
$value = $model->{$attribute}; |
|
63
|
|
|
|
|
64
|
|
|
try { |
|
65
|
|
|
$number = $phoneUtil->parse($value, $this->country); |
|
66
|
|
|
|
|
67
|
|
|
if (!$number || !$phoneUtil->isValidNumber($number)) { |
|
68
|
|
|
return $this->addError($model, $attribute, Yii::t('luya', 'Invalid phone number.')); |
|
69
|
|
|
} |
|
70
|
|
|
|
|
71
|
|
|
if ($this->type !== null && ($phoneUtil->getNumberType($number) !== $this->type)) { |
|
72
|
|
|
$typeName = PhoneNumberType::values()[$this->type]; |
|
73
|
|
|
return $this->addError($model, $attribute, Yii::t('luya', 'The phone number does not match the required type {name}.', ['name' => $typeName])); |
|
74
|
|
|
} |
|
75
|
|
|
|
|
76
|
|
|
// refactor the phone number |
|
77
|
|
|
if ($this->autoFormat) { |
|
78
|
|
|
$model->{$attribute} = $phoneUtil->format($number, $this->autoFormatFormat); |
|
79
|
|
|
} |
|
80
|
|
|
|
|
81
|
|
|
} catch (NumberParseException $exception) { |
|
82
|
|
|
$this->addError($model, $attribute, Yii::t('luya', 'Invalid phone number, ensure it starts with the correct country code.')); |
|
83
|
|
|
} |
|
84
|
|
|
} |
|
85
|
|
|
} |