Aura\Filter\Spec\SanitizeSpec

Complexity

Total Complexity

10

Size/Duplication

Total Lines	129
Duplicated Lines	0 %

Coupling/Cohesion

Components	3
Dependencies	1

Test Coverage

Coverage

100%

Importance

Changes

0

6 Methods

Rating	Name	Duplication	Size	Complexity
B	__invoke()	0	21	5
A	to()	0	5	1
A	toBlankOr()	0	5	1
A	useBlankValue()	0	6	1
A	useBlankField()	0	5	1
A	getDefaultMessage()	0	5	1

<?php
/**
 *
 * This file is part of Aura for PHP.
 *
 * @license http://opensource.org/licenses/bsd-license.php BSD
 *
 */
namespace Aura\Filter\Spec;

/**
 *
 * A "sanitize" rule specification.
 *
 * @package Aura.Filter
 *
 */
class SanitizeSpec extends Spec
{
    /**
     *
     * If the field is blank, use this as the replacement value.
     *
     * @param mixed
     *
     */
    protected $blank_value;

    /**
     *
     * If the field is blank, use value from this field as the replacement value.
     *
     * @param string
     *
     */
    protected $blank_field;

    /**
     *
     * Applies the rule specification to a subject.
     *
     * @param mixed $subject The filter subject.
     *
     * @return bool True on success, false on failure.
     *
     */
    public function __invoke($subject)
    {

        if ($this->subjectFieldIsBlank($subject) && $this->blank_field) {
            $field = $this->field;
            $replace_with = $this->blank_field;
            $subject->$field = $subject->$replace_with;
        }

        if (! $this->subjectFieldIsBlank($subject)) {
            return parent::__invoke($subject);
        }

        if (! $this->allow_blank) {
            return false;
        }

        $field = $this->field;
        $subject->$field = $this->blank_value;
        return true;
    }

    /**
     *
     * Sanitize the field using this rule (blank not allowed).
     *
     * @param string $rule The rule name.
     *
     * @param ...$args Arguments for the rule.
     *
     * @return self
     *
     */
    public function to($rule)

The parameter $rule is not used and could be removed.

    {
        $this->allow_blank = false;
        return $this->init(func_get_args());
    }

    /**
     *
     * Sanitize the using this rule (blank allowed).
     *
     * @param string $rule The rule name.
     *
     * @param ...$args Arguments for the rule.
     *
     * @return self
     *
     */
    public function toBlankOr($rule)

The parameter $rule is not used and could be removed.

    {
        $this->allow_blank = true;
        return $this->init(func_get_args());
    }

    /**
     *
     * Use this value for blank fields.
     *
     * @param mixed $blank_value Replace the blank field with this value.
     *
     * @return self
     *
     */
    public function useBlankValue($blank_value)
    {
        $this->allow_blank = true;
        $this->blank_value = $blank_value;
        return $this;
    }

    /**
     *
     * Use value from $field_name for blank field.
     *
     * @param string $field_name Replace the blank field with the value from field.
     *
     * @return self
     *
     */
    public function useBlankField($field_name)
    {
        $this->blank_field = $field_name;
        return $this;
    }

    /**
     *
     * Returns the default failure message for this rule specification.
     *
     * @return string
     *
     */
    protected function getDefaultMessage()
    {
        return $this->field . ' should have sanitized to '
             . parent::getDefaultMessage();
    }
}