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
|
<?php
namespace Wikimedia\ParamValidator;
use Throwable;
use UnexpectedValueException;
use Wikimedia\Message\DataMessageValue;
/**
* Error reporting for ParamValidator
*
* @newable
* @since 1.34
* @unstable
*/
class ValidationException extends UnexpectedValueException {
/** @var DataMessageValue */
protected $failureMessage;
/** @var string */
protected $paramName;
/** @var mixed */
protected $paramValue;
/** @var array */
protected $settings;
/**
* @stable to call
* @param DataMessageValue $failureMessage
* @param string $name Parameter name being validated
* @param mixed $value Value of the parameter
* @param array $settings Settings array being used for validation
* @param Throwable|null $previous Previous throwable causing this failure
*/
public function __construct(
DataMessageValue $failureMessage, $name, $value, $settings, ?Throwable $previous = null
) {
$this->failureMessage = $failureMessage;
$this->paramName = $name;
$this->paramValue = $value;
$this->settings = $settings;
// Parent class needs some static English message.
$msg = "Validation of `$name` failed: " . $failureMessage->getCode();
$data = $failureMessage->getData();
if ( $data ) {
$msg .= ' ' . json_encode( $data, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE );
}
parent::__construct( $msg, 0, $previous );
}
/**
* Fetch the validation failure message
*
* Users are encouraged to use this with an appropriate message formatter rather
* than relying on the limited English text returned by getMessage().
*
* @return DataMessageValue
*/
public function getFailureMessage() {
return $this->failureMessage;
}
/**
* Fetch the parameter name that failed validation
* @return string
*/
public function getParamName() {
return $this->paramName;
}
/**
* Fetch the parameter value that failed validation
* @return mixed
*/
public function getParamValue() {
return $this->paramValue;
}
/**
* Fetch the settings array that failed validation
* @return array
*/
public function getSettings() {
return $this->settings;
}
}
|
