Completed
Pull Request — master (#4)
by Todd
03:36 queued 01:53
created

Validation::getErrorCount()   A

Complexity

Conditions 3
Paths 3

Size

Total Lines 9
Code Lines 7

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 5
CRAP Score 3.0416

Importance

Changes 0
Metric Value
dl 0
loc 9
ccs 5
cts 6
cp 0.8333
rs 9.6666
c 0
b 0
f 0
cc 3
eloc 7
nc 3
nop 1
crap 3.0416
1
<?php
2
/**
3
 * @author Todd Burry <[email protected]>
4
 * @copyright 2009-2017 Vanilla Forums Inc.
5
 * @license MIT
6
 */
7
8
namespace Garden\Schema;
9
10
/**
11
 * An class for collecting validation errors.
12
 */
13
class Validation {
14
    /**
15
     * @var array
16
     */
17
    private $errors = [];
18
19
    /**
20
     * @var string
21
     */
22
    private $mainMessage = '';
23
24
    /**
25
     * @var int
26
     */
27
    private $mainStatus = 0;
28
29
    /**
30
     * @var bool Whether or not fields should be translated.
31
     */
32
    private $translateFieldNames = false;
33
34
    /**
35
     * Add an error.
36
     *
37
     * @param string $field The name and path of the field to add or an empty string if this is a global error.
38
     * @param string $error The message code.
39
     * @param int|array $options An array of additional information to add to the error entry or a numeric error code.
40
     * @return $this
41
     */
42 66
    public function addError($field, $error, $options = []) {
43 66
        if (empty($error)) {
44
            throw new \InvalidArgumentException('The error code cannot be empty.', 500);
45
        }
46
47 66
        $fieldKey = $field;
48 66
        $row = ['field' => null, 'code' => null, 'path' => null, 'index' => null];
0 ignored issues
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 6 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
49
50
        // Split the field out into a path, field, and possible index.
51 66
        if (($pos = strrpos($field, '.')) !== false) {
52 5
            $row['path'] = substr($field, 0, $pos);
53 5
            $field = substr($field, $pos + 1);
0 ignored issues
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 7 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
54
        }
55 66
        if (preg_match('`^([^[]+)\[(\d+)\]$`', $field, $m)) {
56 3
            $row['index'] = (int)$m[2];
57 3
            $field = $m[1];
0 ignored issues
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 8 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
58
        }
59 66
        $row['field'] = $field;
60 66
        $row['code'] = $error;
1 ignored issue
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 2 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
61
62
        $row = array_filter($row, function ($v) {
63 66
            return $v !== null;
64 66
        });
65
66 66
        if (is_array($options)) {
67 63
            $row += $options;
68 4
        } elseif (is_int($options)) {
69 4
            $row['status'] = $options;
70
        }
71
72 66
        $this->errors[$fieldKey][] = $row;
73
74 66
        return $this;
75
    }
76
77
    /**
78
     * Get or set the error status code.
79
     *
80
     * The status code is an http response code and should be of the 4xx variety.
81
     *
82
     * @return int Returns the current status code.
83
     */
84 59
    public function getStatus() {
85 59
        if ($status = $this->getMainStatus()) {
86 1
            return $status;
87
        }
88
89 58
        if ($this->isValid()) {
90 1
            return 200;
91
        }
92
93
        // There was no status so loop through the errors and look for the highest one.
94 57
        $maxStatus = 0;
95 57
        foreach ($this->getRawErrors() as $error) {
96 57
            if (isset($error['status']) && $error['status'] > $maxStatus) {
97 52
                $maxStatus = $error['status'];
98
            }
99
        }
100
101 57
        return $maxStatus?: 400;
102
    }
103
104
    /**
105
     * Get the message for this exception.
106
     *
107
     * @return string Returns the exception message.
108
     */
109 60
    public function getMessage() {
110 60
        if ($message = $this->getMainMessage()) {
111 1
            return $message;
112
        }
113
114 59
        $sentence = $this->translate('%s.');
115
116
        // Generate the message by concatenating all of the errors together.
117 59
        $messages = [];
118 59
        foreach ($this->getRawErrors() as $error) {
119 59
            $message = $this->getErrorMessage($error);
120 59
            if (preg_match('`\PP$`u', $message)) {
121 2
                $message = sprintf($sentence, $message);
122
            }
123 59
            $messages[] = $message;
124
        }
125 59
        return implode(' ', $messages);
126
    }
127
128
    /**
129
     * Gets all of the errors as a flat array.
130
     *
131
     * The errors are internally stored indexed by field. This method flattens them for final error returns.
132
     *
133
     * @return array Returns all of the errors.
134
     */
135 4
    public function getErrors() {
136 4
        $result = [];
137 4
        foreach ($this->getRawErrors() as $error) {
138 4
            $result[] = $this->formatError($error);
139
        }
140 4
        return $result;
141
    }
142
143
    /**
144
     * Get the errors for a specific field.
145
     *
146
     * @param string $field The full path to the field.
147
     * @return array Returns an array of errors.
148
     */
149 6
    public function getFieldErrors($field) {
150 6
        if (empty($this->errors[$field])) {
151
            return [];
152
        } else {
153 6
            $result = [];
154 6
            foreach ($this->errors[$field] as $error) {
155 6
                $result[] = $this->formatError($error);
156
            }
157 6
            return $result;
158
        }
159
    }
160
161
    /**
162
     * Gets all of the errors as a flat array.
163
     *
164
     * The errors are internally stored indexed by field. This method flattens them for final error returns.
165
     *
166
     * @return \Traversable Returns all of the errors.
167
     */
168 74
    protected function getRawErrors() {
169 74
        foreach ($this->errors as $errors) {
170 63
            foreach ($errors as $error) {
171 63
                yield $error;
172
            }
173
        }
174 74
    }
175
176
    /**
177
     * Check whether or not the validation is free of errors.
178
     *
179
     * @return bool Returns true if there are no errors, false otherwise.
180
     */
181 117
    public function isValid() {
182 117
        return empty($this->errors);
183
    }
184
185
    /**
186
     * Check whether or not a particular field is has errors.
187
     *
188
     * @param string $field The name of the field to check for validity.
189
     * @return bool Returns true if the field has no errors, false otherwise.
190
     */
191 76
    public function isValidField($field) {
192 76
        $result = empty($this->errors[$field]);
193 76
        return $result;
194
    }
195
196
    /**
197
     * Get the error count, optionally for a particular field.
198
     *
199
     * @param string $field The name of a field or an empty string for all errors.
200
     * @return int Returns the error count.
201
     */
202 48
    public function getErrorCount($field = '') {
203 48
        if (empty($field)) {
204 17
            return iterator_count($this->getRawErrors());
205 31
        } elseif (empty($this->errors[$field])) {
206 31
            return 0;
207
        } else {
208
            return count($this->errors[$field]);
209
        }
210
    }
211
212
    /**
213
     * Get the error message for an error row.
214
     *
215
     * @param array $error The error row.
216
     * @return string Returns a formatted/translated error message.
217
     */
218 61
    private function getErrorMessage(array $error) {
219 61
        if (isset($error['messageCode'])) {
220 55
            $messageCode = $error['messageCode'];
221 7
        } elseif (isset($error['message'])) {
222
            return $error['message'];
223
        } else {
224 7
            $messageCode = $error['code'];
225
        }
226
227
        // Massage the field name for better formatting.
228 61
        if (!$this->getTranslateFieldNames()) {
229 60
            $field = (!empty($error['path']) ? ($error['path'][0] !== '[' ?: 'item').$error['path'].'.' : '').$error['field'];
230 60
            $field = $field ?: (isset($error['index']) ? 'item' : 'value');
231 60
            if (isset($error['index'])) {
232 3
                $field .= '['.$error['index'].']';
233
            }
234 60
            $error['field'] = '@'.$field;
235 2
        } elseif (isset($error['index'])) {
236
            if (empty($error['field'])) {
237
                $error['field'] = '@'.$this->formatMessage('item {index}', $error);
238
            } else {
239
                $error['field'] = '@'.$this->formatMessage('{field} at position {index}', $error);
240
            }
241 2
        } elseif (empty($error['field'])) {
242 1
            $error['field'] = 'value';
243
        }
244
245 61
        $msg = $this->formatMessage($messageCode, $error);
246 61
        return $msg;
247
    }
248
249
    /**
250
     * Expand and translate a message format against an array of values.
251
     *
252
     * @param string $format The message format.
253
     * @param array $context The context arguments to apply to the message.
254
     * @return string Returns a formatted string.
255
     */
256 61
    private function formatMessage($format, $context = []) {
257 61
        $format = $this->translate($format);
258
259 61
        $msg = preg_replace_callback('`({[^{}]+})`', function ($m) use ($context) {
260 58
            $args = array_filter(array_map('trim', explode(',', trim($m[1], '{}'))));
1 ignored issue
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 2 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
261 58
            $field = array_shift($args);
262 58
            return $this->formatField(isset($context[$field]) ? $context[$field] : null, $args);
263 61
        }, $format);
264 61
        return $msg;
265
    }
266
267
    /**
268
     * Translate an argument being placed in an error message.
269
     *
270
     * @param mixed $value The argument to translate.
271
     * @param array $args Formatting arguments.
272
     * @return string Returns the translated string.
273
     */
274 58
    private function formatField($value, array $args = []) {
275 58
        if (is_string($value)) {
276 57
            $r = $this->translate($value);
277 9
        } elseif (is_numeric($value)) {
278 5
            $r = $value;
279 4
        } elseif (is_array($value)) {
280 4
            $argArray = array_map([$this, 'formatField'], $value);
281 4
            $r = implode(', ', $argArray);
0 ignored issues
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 8 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
282
        } elseif ($value instanceof \DateTimeInterface) {
283
            $r = $value->format('c');
284
        } else {
285
            $r = $value;
286
        }
287
288 58
        $format = array_shift($args);
289
        switch ($format) {
290 58
            case 'plural':
291 6
                $singular = array_shift($args);
292 6
                $plural = array_shift($args) ?: $singular.'s';
0 ignored issues
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 3 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
293 6
                $count = is_array($value) ? count($value) : $value;
0 ignored issues
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 4 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
294 6
                $r = $count == 1 ? $singular : $plural;
0 ignored issues
show
Coding Style introduced by
Equals sign not aligned with surrounding assignments; expected 8 spaces but found 1 space

This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line.

To visualize

$a = "a";
$ab = "ab";
$abc = "abc";

will produce issues in the first and second line, while this second example

$a   = "a";
$ab  = "ab";
$abc = "abc";

will produce no issues.

Loading history...
295 6
                break;
296
        }
297
298 58
        return (string)$r;
299
    }
300
301
    /**
302
     * Translate a string.
303
     *
304
     * This method doesn't do any translation itself, but is meant for subclasses wanting to add translation ability to
305
     * this class.
306
     *
307
     * @param string $str The string to translate.
308
     * @return string Returns the translated string.
309
     */
310 62
    public function translate($str) {
311 62
        if (substr($str, 0, 1) === '@') {
312
            // This is a literal string that bypasses translation.
313 55
            return substr($str, 1);
314
        } else {
315 61
            return $str;
316
        }
317
    }
318
319
    /**
320
     * Merge another validation object with this one.
321
     *
322
     * @param Validation $validation The validation object to merge.
323
     * @param string $name The path to merge to. Use this parameter when the validation object is meant to be a subset of this one.
324
     * @return $this
325
     */
326 1
    public function merge(Validation $validation, $name = '') {
327 1
        $paths = $validation->errors;
328
329 1
        foreach ($paths as $path => $errors) {
330 1
            foreach ($errors as $error) {
331 1
                if (!empty($name)) {
332 1
                    $fullPath = "{$name}.{$path}";
333 1
                    $this->addError($fullPath, $error['code'], $error);
334
                }
335
            }
336
        }
337 1
        return $this;
338
    }
339
340
    /**
341
     * Get the main error message.
342
     *
343
     * If set, this message will be returned as the error message. Otherwise the message will be set from individual
344
     * errors.
345
     *
346
     * @return string Returns the main message.
347
     */
348 60
    public function getMainMessage() {
349 60
        return $this->mainMessage;
350
    }
351
352
    /**
353
     * Set the main error message.
354
     *
355
     * @param string $message The new message.
356
     * @return $this
357
     */
358 1
    public function setMainMessage($message) {
359 1
        $this->mainMessage = $message;
360 1
        return $this;
361
    }
362
363
    /**
364
     * Get the main status.
365
     *
366
     * @return int Returns an HTTP response code or zero to indicate it should be calculated.
367
     */
368 59
    public function getMainStatus() {
369 59
        return $this->mainStatus;
370
    }
371
372
    /**
373
     * Set the main status.
374
     *
375
     * @param int $status An HTTP response code or zero.
376
     * @return $this
377
     */
378 1
    public function setMainStatus($status) {
379 1
        $this->mainStatus = $status;
380 1
        return $this;
381
    }
382
383
    /**
384
     * Whether or not fields should be translated.
385
     *
386
     * @return bool Returns **true** if field names are translated or **false** otherwise.
387
     */
388 61
    public function getTranslateFieldNames() {
389 61
        return $this->translateFieldNames;
390
    }
391
392
    /**
393
     * Set whether or not fields should be translated.
394
     *
395
     * @param bool $translate Whether or not fields should be translated.
396
     * @return $this
397
     */
398 2
    public function setTranslateFieldNames($translate) {
399 2
        $this->translateFieldNames = $translate;
400 2
        return $this;
401
    }
402
403
    /**
404
     * @param $error
405
     * @return array
406
     */
407 10
    private function formatError($error) {
408 10
        $row = array_intersect_key(
409
            $error,
410 10
            ['field' => 1, 'path' => 1, 'index' => 1, 'code' => 1]
411
        );
412
413 10
        $row['message'] = $this->getErrorMessage($error);
414 10
        return $row;
415
    }
416
}
417