AlibabaCloud\Client\Request\UserAgent

Complexity

Total Complexity

12

Size/Duplication

Total Lines	105
Duplicated Lines	0 %

Test Coverage

Coverage

94.29%

Importance

Changes

0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	isGuarded()	0	3	1
A	append()	0	6	2
A	toString()	0	22	3
A	clear()	0	3	1
A	with()	0	4	2
A	defaultFields()	0	10	3

<?php

namespace AlibabaCloud\Client\Request;

use AlibabaCloud\Client\AlibabaCloud;
use GuzzleHttp\Client;

/**
 * Class UserAgent
 *
 * @package AlibabaCloud\Client\Request
 */
class UserAgent
{

    /**
     * @var array
     */
    private static $userAgent = [];

    /**
     * @var array
     */
    private static $guard = [
        'client',
        'guzzlehttp',
        'curl',
        'php',
    ];

    /**
     * UserAgent constructor.
     */
    private static function defaultFields()
    {
        if (self::$userAgent === []) {
            self::$userAgent = [
                'Client'     => AlibabaCloud::VERSION,
                'GuzzleHttp' => Client::VERSION,
                'curl'       => isset(\curl_version()['version'])
                    ? \curl_version()['version']
                    : 'none',
                'PHP'        => \PHP_VERSION,
            ];
        }
    }

    /**
     * @param array $append
     *
     * @return string
     */
    public static function toString(array $append = [])
    {
        self::defaultFields();

        $os         = \PHP_OS;
        $os_version = php_uname('r');
        $os_mode    = php_uname('m');
        $userAgent  = "AlibabaCloud ($os $os_version; $os_mode) ";

        $newUserAgent = [];

        $append = array_merge(self::$userAgent, $append);

        foreach ($append as $key => $value) {
            if ($value === null) {
                $newUserAgent[] = $key;
                continue;
            }
            $newUserAgent[] = "$key/$value";
        }

        return $userAgent . \implode(' ', $newUserAgent);
    }

    /**
     * set User Agent of Alibaba Cloud.
     *
     * @param string $name
     * @param string $value
     */
    public static function append($name, $value)
    {
        self::defaultFields();

        if (!self::isGuarded($name)) {
            self::$userAgent[$name] = $value;
        }
    }

    /**
     * @param array $userAgent
     */
    public static function with(array $userAgent)
    {
        foreach ($userAgent as $key => $value) {
            self::append($key, $value);
        }
    }

    /**
     * Clear all of the User Agent.
     */
    public static function clear()
    {
        self::$userAgent = [];
    }

    /**
     * @param $name
     *
     * @return bool
     */
    public static function isGuarded($name)
    {
        return in_array(strtolower($name), self::$guard, true);
    }
}