drupol\htmltag\AbstractBaseHtmlTagObject

Complexity

Total Complexity

13

Size/Duplication

Total Lines	133
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	0

Test Coverage

Coverage

100%

Importance

Changes

0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	escapeValues()	0	7	1
A	normalizeValues()	0	7	1
A	ensureFlatArray()	0	19	2
B	ensureString()	0	26	8
A	preprocess()	0	4	1
	escape()	0	1	?

<?php

namespace drupol\htmltag;

/**
 * Class AbstractBaseHtmlTagObject
 */
abstract class AbstractBaseHtmlTagObject
{
    /**
     * Escape values.
     *
     * @param array $values
     *   The values to escape.
     *
     * @return array
     *   The values escaped.
     */
    protected function escapeValues(array $values)
    {
        return \array_map(
            [$this, 'escape'],
            $values
        );
    }

    /**
     * Normalize the values.
     *
     * @param mixed $values
     *  The value to normalize.
     *
     * @return array
     *   The value normalized.
     */
    protected function normalizeValues($values)
    {
        return \array_filter(
            $this->escapeValues($values),
            '\is_string'
        );
    }

    /**
     * Transform a multidimensional array into a flat array.
     *
     * We could use a iterator_to_array() with a custom RecursiveArrayIterator.
     * But it seems to be even slower.
     *
     * @see http://php.net/manual/en/class.recursivearrayiterator.php#106519
     *
     * @param mixed[] $array
     *   The input array.
     *
     * @return mixed[]
     *   The array with only one dimension.
     */
    protected function ensureFlatArray(array $array)
    {
        return \array_reduce(
            $array,
            function ($carry, $item) {
                if (\is_array($item)) {
                    return \array_merge(
                        $carry,
                        $this->ensureFlatArray($item)
                    );
                }

                $carry[] = $item;

                return $carry;
            },
            []
        );
    }

    /**
     * Make sure the value is an array.
     *
     * @param mixed $data
     *   The input value.
     *
     * @return string|null
     *   The input value in an array.
     */
    protected function ensureString($data)
    {
        $return = null;

        switch (\gettype($data)) {
            case 'string':
                $return = $data;
                break;
            case 'integer':
            case 'double':
                $return = (string) $data;
                break;
            case 'object':
                if (\method_exists($data, '__toString')) {
                    $return = $data->__toString();
                }
                break;
            case 'boolean':
            case 'array':
            default:
                $return = null;
                break;
        }

        return $return;
    }

    /**
     * Preprocess values before they are returned to user.
     *
     * @param array $values
     *   The raw values.
     * @param string $name
     *   The name of the object.
     *
     * @return array|\drupol\htmltag\Attribute\AttributeInterface[]
     *   The values.
     */
    public function preprocess(array $values, $name = null)

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

    {
        return $values;
    }

    /**
     * Sanitize a value.
     *
     * @param string|mixed $value
     *   The value to sanitize
     *
     * @return string|mixed
     *   The value sanitized.
     */
    abstract protected function escape($value);
}