Phalcon\Http\Message\Traits\CommonTrait

Complexity

Total Complexity

4

Size/Duplication

Total Lines	46
Duplicated Lines	0 %

Test Coverage

Coverage

0%

Importance

Changes

0

3 Methods

Rating	Name	Duplication	Size	Complexity
A	cloneInstance()	0	6	1
A	processWith()	0	5	1
A	checkStringParameter()	0	5	2

<?php

/**
 * This file is part of the Phalcon Framework.
 *
 * (c) Phalcon Team <team@phalcon.io>
 *
 * For the full copyright and license information, please view the LICENSE.txt
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace Phalcon\Http\Message\Traits;

use Phalcon\Http\Message\Exception\InvalidArgumentException;

use function is_string;

/**
 * Trait Common
 */
trait CommonTrait
{
    /**
     * Returns a new instance having set the parameter
     *
     * @param mixed  $element
     * @param string $property
     *
     * @return mixed
     */
    protected function cloneInstance($element, string $property)
    {
        $newInstance              = clone $this;
        $newInstance->{$property} = $element;

        return $newInstance;
    }

    /**
     * Checks the element passed if it is a string
     *
     * @param mixed $element
     */
    private function checkStringParameter($element): void
    {
        if (!is_string($element)) {
            throw new InvalidArgumentException(
                'Method requires a string argument'
            );
        }
    }

    /**
     * Checks the element passed; assigns it to the property and returns a
     * clone of the object back
     *
     * @param mixed  $element
     * @param string $property
     *
     * @return mixed
     */
    private function processWith($element, string $property)
    {
        $this->checkStringParameter($element);

        return $this->cloneInstance($element, $property);
    }
}