respect-validation/library/Rules/Charset.php

<?php

/*
 * Copyright (c) Alexandre Gomes Gaigalas <alganet@gmail.com>
 * SPDX-License-Identifier: MIT
 */

declare(strict_types=1);

namespace Respect\Validation\Rules;

use Attribute;
use Respect\Validation\Exceptions\InvalidRuleConstructorException;
use Respect\Validation\Message\Template;
use Respect\Validation\Result;
use Respect\Validation\Rule;

use function array_diff;
use function array_merge;
use function array_values;
use function count;
use function in_array;
use function mb_detect_encoding;
use function mb_list_encodings;

#[Attribute(Attribute::TARGET_PROPERTY | Attribute::IS_REPEATABLE)]
#[Template(
    '{{name}} must only contain characters from the {{charset|raw}} charset',
    '{{name}} must not contain any characters from the {{charset|raw}} charset',
)]
final readonly class Charset implements Rule
{
    /** @var non-empty-array<string> */
    private array $charset;

    public function __construct(string $charset, string ...$charsets)
    {
        $available = mb_list_encodings();
        $charsets = array_merge([$charset], $charsets);
        $diff = array_diff($charsets, $available);
        if (count($diff) > 0) {
            throw new InvalidRuleConstructorException('Invalid charset provided: %s', array_values($diff));
        }

        $this->charset = $charsets;
    }

    public function evaluate(mixed $input): Result
    {
        return new Result(
            in_array(mb_detect_encoding($input, $this->charset, true), $this->charset),
            $input,
            $this,
            ['charset' => $this->charset],
        );
    }
}