ILIAS\Validation\Constraints\Custom Class Reference

Inheritance diagram for ILIAS\Validation\Constraints\Custom:

Collaboration diagram for ILIAS\Validation\Constraints\Custom:

Public Member Functions
	__construct (callable $is_ok, $error, Data\Factory $data_factory, \ilLanguage $lng)
	If $error is a callable it needs to take two parameters: More...
	check ($value)
	Checks the provided value.Should not throw if accepts($value). Exceptions More...
	accepts ($value)
	Tells if the provided value complies. Parameters mixed $value Returns bool More...
	problemWith ($value)
	Tells what the problem with the provided value is.Should return null if accepts($value). Parameters mixed $value Returns string|null More...
	restrict (Result $result)
	Restricts a Result.Must do nothing with the result if $result->isError(). Must replace the result with an error according to problemWith() if !accepts($result->value()). Parameters Result $result Returns Result More...
	withProblemBuilder (callable $builder)
	Get a constraint like this one with a builder for a custom error message.problemWith() must return an error message according to the new builder for the new constraint.The builder needs to be callable that takes two parameters: Parameters callable $builder Returns Constraint More...
	getErrorMessage ($value)
	Get the problem message. More...

Protected Member Functions
	getLngClosure ()
	Get the closure to be passed to the error-function that does i18n and sprintf. More...

Protected Attributes
	$data_factory
	$lng
	$is_ok
	$error

Detailed Description

Definition at line 10 of file Custom.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Validation\Constraints\Custom::__construct	(	callable	$is_ok,
			$error,
		Data\Factory	$data_factory,
		\ilLanguage	$lng
	)

If $error is a callable it needs to take two parameters:

• one callback $txt($lng_id, ($value, ...)) that retrieves the lang var with the given id and uses sprintf to replace placeholder if more values are provide.
• the $value for which the error message should be build.

Parameters

string | callable

$error

Definition at line 41 of file Custom.php.

References ILIAS\Validation\Constraints\Custom\$data_factory, ILIAS\Validation\Constraints\Custom\$error, ILIAS\Validation\Constraints\Custom\$is_ok, and ILIAS\Validation\Constraints\Custom\$lng.

    {
        $this->is_ok = $is_ok;

        if (!is_callable($error)) {
            $this->error = function () use ($error) {
                return $error;
            };
        } else {
            $this->error = $error;
        }

        $this->data_factory = $data_factory;
        $this->lng = $lng;
    }

Member Function Documentation

accepts()

ILIAS\Validation\Constraints\Custom::accepts (   $value )

final

Tells if the provided value complies.

Parameters

mixed

$value

Returns

bool

Implements ILIAS\Validation\Constraint.

Definition at line 72 of file Custom.php.

Referenced by ILIAS\Validation\Constraints\Custom\check(), ILIAS\Validation\Constraints\Custom\problemWith(), and LogicalOrTest\testAccept().

    {
        return call_user_func($this->is_ok, $value);
    }

Here is the caller graph for this function:

check()

ILIAS\Validation\Constraints\Custom::check (   $value )

final

Checks the provided value.Should not throw if accepts($value).

Exceptions

Implements ILIAS\Validation\Constraint.

Definition at line 60 of file Custom.php.

References ILIAS\Validation\Constraints\Custom\accepts(), and ILIAS\Validation\Constraints\Custom\getErrorMessage().

Referenced by LogicalOrTest\testCheck().

    {
        if (!$this->accepts($value)) {
            throw new \UnexpectedValueException($this->getErrorMessage($value));
        }

        return null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getErrorMessage()

ILIAS\Validation\Constraints\Custom::getErrorMessage (   $value )

final

Get the problem message.

Returns

string

Definition at line 122 of file Custom.php.

References ILIAS\Validation\Constraints\Custom\getLngClosure().

Referenced by ILIAS\Validation\Constraints\Custom\check(), and ILIAS\Validation\Constraints\Custom\problemWith().

    {
        $lng_closure = $this->getLngClosure();
        return call_user_func($this->error, $lng_closure, $value);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getLngClosure()

ILIAS\Validation\Constraints\Custom::getLngClosure ( )

finalprotected

Get the closure to be passed to the error-function that does i18n and sprintf.

Returns

Definition at line 134 of file Custom.php.

References ILIAS\Validation\Constraints\Custom\$error, and $i.

Referenced by ILIAS\Validation\Constraints\Custom\getErrorMessage().

    {
        return function () {
            $args = func_get_args();
            if (count($args) < 1) {
                throw new \InvalidArgumentException(
                    "Expected an id of a lang var as first parameter"
                );
            }
            $error = $this->lng->txt($args[0]);
            if (count($args) > 1) {
                $args[0] = $error;
                for ($i = 0; $i < count($args); $i++) {
                    $v = $args[$i];
                    if ((is_array($v) || is_object($v) || is_null($v))
                    && !method_exists($v, "__toString")) {
                        if (is_array($v)) {
                            $args[$i] = "array";
                        } elseif (is_null($v)) {
                            $args[$i] = "null";
                        } else {
                            $args[$i] = get_class($v);
                        }
                    }
                }
                $error = call_user_func_array("sprintf", $args);
            }
            return $error;
        };
    }

Here is the caller graph for this function:

problemWith()

ILIAS\Validation\Constraints\Custom::problemWith (   $value )

final

Tells what the problem with the provided value is.Should return null if accepts($value).

Parameters

mixed

$value

Returns

string|null

Implements ILIAS\Validation\Constraint.

Definition at line 80 of file Custom.php.

References ILIAS\Validation\Constraints\Custom\accepts(), and ILIAS\Validation\Constraints\Custom\getErrorMessage().

Referenced by ILIAS\Validation\Constraints\Custom\restrict(), and LogicalOrTest\testProblemWith().

    {
        if (!$this->accepts($value)) {
            return $this->getErrorMessage($value);
        }

        return null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

restrict()

ILIAS\Validation\Constraints\Custom::restrict ( Result  $result )

final

Restricts a Result.Must do nothing with the result if $result->isError(). Must replace the result with an error according to problemWith() if !accepts($result->value()).

Parameters

Result

$result

Returns

Result

Implements ILIAS\Validation\Constraint.

Definition at line 92 of file Custom.php.

References ILIAS\Validation\Constraints\Custom\$error, $result, ILIAS\Data\Result\isError(), ILIAS\Validation\Constraints\Custom\problemWith(), and ILIAS\Data\Result\value().

Referenced by LogicalOrTest\testRestrict().

    {
        if ($result->isError()) {
            return $result;
        }

        $problem = $this->problemWith($result->value());
        if ($problem !== null) {
            $error = $this->data_factory->error($problem);
            return $error;
        }

        return $result;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

withProblemBuilder()

ILIAS\Validation\Constraints\Custom::withProblemBuilder ( callable  $builder )

final

Get a constraint like this one with a builder for a custom error message.problemWith() must return an error message according to the new builder for the new constraint.The builder needs to be callable that takes two parameters:

Parameters

callable

$builder

Returns

Constraint

Implements ILIAS\Validation\Constraint.

Definition at line 110 of file Custom.php.

References $builder.

Referenced by LogicalOrTest\testWithProblemBuilder().

    {
        $clone = clone $this;
        $clone->error = $builder;
        return $clone;
    }

Here is the caller graph for this function:

Field Documentation

$data_factory

ILIAS\Validation\Constraints\Custom::$data_factory

protected

Definition at line 15 of file Custom.php.

Referenced by ILIAS\Validation\Constraints\IsInt\__construct(), ILIAS\Validation\Constraints\Password\HasNumbers\__construct(), ILIAS\Validation\Constraints\Password\HasUpperChars\__construct(), ILIAS\Validation\Constraints\Password\HasLowerChars\__construct(), ILIAS\Validation\Constraints\IsNumeric\__construct(), ILIAS\Validation\Constraints\Password\HasSpecialChars\__construct(), ILIAS\Validation\Constraints\HasMaxLength\__construct(), ILIAS\Validation\Constraints\Not\__construct(), ILIAS\Validation\Constraints\HasMinLength\__construct(), ILIAS\Validation\Constraints\Password\HasMinLength\__construct(), ILIAS\Validation\Constraints\LessThan\__construct(), ILIAS\Validation\Constraints\GreaterThan\__construct(), ILIAS\Validation\Constraints\IsString\__construct(), ILIAS\Validation\Constraints\IsArrayOf\__construct(), ILIAS\Validation\Constraints\Parallel\__construct(), ILIAS\Validation\Constraints\IsNull\__construct(), ILIAS\Validation\Constraints\Sequential\__construct(), ILIAS\Validation\Constraints\LogicalOr\__construct(), and ILIAS\Validation\Constraints\Custom\__construct().

$error

ILIAS\Validation\Constraints\Custom::$error

protected

Definition at line 30 of file Custom.php.

Referenced by ILIAS\Validation\Constraints\Custom\__construct(), ILIAS\Validation\Constraints\Custom\getLngClosure(), and ILIAS\Validation\Constraints\Custom\restrict().

$is_ok

ILIAS\Validation\Constraints\Custom::$is_ok

protected

Definition at line 25 of file Custom.php.

Referenced by ILIAS\Validation\Constraints\Custom\__construct().

$lng

ILIAS\Validation\Constraints\Custom::$lng

protected

Definition at line 20 of file Custom.php.

Referenced by ILIAS\Validation\Constraints\IsInt\__construct(), ILIAS\Validation\Constraints\Password\HasLowerChars\__construct(), ILIAS\Validation\Constraints\Password\HasNumbers\__construct(), ILIAS\Validation\Constraints\Password\HasUpperChars\__construct(), ILIAS\Validation\Constraints\IsNumeric\__construct(), ILIAS\Validation\Constraints\Password\HasSpecialChars\__construct(), ILIAS\Validation\Constraints\HasMaxLength\__construct(), ILIAS\Validation\Constraints\Not\__construct(), ILIAS\Validation\Constraints\GreaterThan\__construct(), ILIAS\Validation\Constraints\HasMinLength\__construct(), ILIAS\Validation\Constraints\LessThan\__construct(), ILIAS\Validation\Constraints\Password\HasMinLength\__construct(), ILIAS\Validation\Constraints\IsString\__construct(), ILIAS\Validation\Constraints\Sequential\__construct(), ILIAS\Validation\Constraints\IsArrayOf\__construct(), ILIAS\Validation\Constraints\Parallel\__construct(), ILIAS\Validation\Constraints\IsNull\__construct(), ILIAS\Validation\Constraints\LogicalOr\__construct(), ilTermsOfServiceDocumentCriterionAssignmentConstraint\__construct(), and ILIAS\Validation\Constraints\Custom\__construct().

---

The documentation for this class was generated from the following file:

• src/Validation/Constraints/Custom.php