1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
<?php
/**
* @see https://github.com/zendframework/zend-uri for the canonical source repository
* @copyright Copyright (c) 2005-2018 Zend Technologies USA Inc. (https://www.zend.com)
* @license https://github.com/zendframework/zend-uri/blob/master/LICENSE.md New BSD License
*/
namespace Zend\Uri;
use Zend\Validator\EmailAddress as EmailValidator;
use Zend\Validator\ValidatorInterface;
/**
* "Mailto" URI handler
*
* The 'mailto:...' scheme is loosely defined in RFC-1738
*/
class Mailto extends Uri
{
protected static $validSchemes = ['mailto'];
/**
* Validator for use when validating email address
* @var ValidatorInterface
*/
protected $emailValidator;
/**
* Check if the URI is a valid Mailto URI
*
* This applies additional specific validation rules beyond the ones
* required by the generic URI syntax
*
* @return bool
* @see Uri::isValid()
*/
public function isValid()
{
if ($this->host || $this->userInfo || $this->port) {
return false;
}
if (empty($this->path)) {
return false;
}
if (0 === strpos($this->path, '/')) {
return false;
}
$validator = $this->getValidator();
return $validator->isValid($this->path);
}
/**
* Set the email address
*
* This is in fact equivalent to setPath() - but provides a more clear interface
*
* @param string $email
* @return Mailto
*/
public function setEmail($email)
{
return $this->setPath($email);
}
/**
* Get the email address
*
* This is infact equivalent to getPath() - but provides a more clear interface
*
* @return string
*/
public function getEmail()
{
return $this->getPath();
}
/**
* Set validator to use when validating email address
*
* @param ValidatorInterface $validator
* @return Mailto
*/
public function setValidator(ValidatorInterface $validator)
{
$this->emailValidator = $validator;
return $this;
}
/**
* Retrieve validator for use with validating email address
*
* If none is currently set, an EmailValidator instance with default options
* will be used.
*
* @return ValidatorInterface
*/
public function getValidator()
{
if (null === $this->emailValidator) {
$this->setValidator(new EmailValidator());
}
return $this->emailValidator;
}
}