Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
100.00%
25 / 25
100.00%
1 / 1
 CRAP
100.00%
1 / 1
HasOnlyOneThatEquals
100.00%
25 / 25
100.00%
1 / 1
 13
100.00%
1 / 1
 evaluate
100.00%
25 / 25
100.00%
1 / 1
 13
1<?php
2/**
3 * Pop PHP Framework (http://www.popphp.org/)
4 *
5 * @link       https://github.com/popphp/popphp-framework
6 * @author     Nick Sagona, III <dev@noladev.com>
7 * @copyright  Copyright (c) 2009-2025 NOLA Interactive, LLC.
8 * @license    http://www.popphp.org/license     New BSD License
9 */
10
11/**
12 * @namespace
13 */
14namespace Pop\Validator;
15
16/**
17 * Has one that equals validator class
18 *
19 * @category   Pop
20 * @package    Pop\Validator
21 * @author     Nick Sagona, III <dev@noladev.com>
22 * @copyright  Copyright (c) 2009-2025 NOLA Interactive, LLC.
23 * @license    http://www.popphp.org/license     New BSD License
24 * @version    4.5.0
25 */
26class HasOnlyOneThatEquals extends AbstractValidator
27{
28
29    /**
30     * Traits
31     */
32    use TraverseTrait;
33
34    /**
35     * Method to evaluate the validator
36     *
37     * @param  mixed $input
38     * @throws Exception
39     * @return bool
40     */
41    public function evaluate(mixed $input = null): bool
42    {
43        // Set the input, if passed
44        if ($input !== null) {
45            $this->input = $input;
46        }
47
48        $result = false;
49
50        if (!is_array($input)) {
51            throw new Exception('Error: The evaluated input must be an array.');
52        }
53        if (!is_array($this->value)) {
54            throw new Exception("Error: The evaluated value must be an array of node name and value, e.g. ['node.name' => 3].");
55        }
56
57        $field         = array_key_first($this->value);
58        $requiredValue = reset($this->value);
59
60        // Set the default message
61        if ($this->message === null) {
62            $this->message = 'The value must contain only one item' .
63                (($this->value !== null) ? " of '" . $field . "'" : '') . ' with the required value.';
64        }
65
66        if (!str_contains($field, '.')) {
67            throw new Exception("Error: The evaluated value must been an array with a column name, e.g. 'users.username'.");
68        }
69
70        $parent = substr($field, 0, strrpos($field, '.'));
71        $child  = substr($field, (strrpos($field, '.') + 1));
72        $value  = [];
73        $count  = 0;
74        self::traverseData($parent, $this->input, $value);
75
76        foreach ($value as $val) {
77            if (is_array($val)) {
78                foreach ($val as $item) {
79                    if (is_array($item) && isset($item[$child]) && ($item[$child] == $requiredValue)) {
80                        $count++;
81                    }
82                }
83            }
84        }
85
86        return ($count == 1);
87    }
88
89}