Sms::hasAgent() - Code Metrics - Inspection of "Merge pull request #133 from toplan/dev" - toplan/phpsms - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 1d8fed...863918 )

by lan tian

created 2017-07-10 17:23 UTC

Sms::hasAgent() A

↳ Parent: Sms

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes

Metric	Value
dl	0
loc	4
ccs	2
cts	2
cp	1
rs	10
c	0
b	0
f	0
cc	1
eloc	2
nc	1
nop	1
crap	1

<?php

namespace Toplan\PhpSms;

use Toplan\TaskBalance\Driver;
use Toplan\TaskBalance\Task;

/**
 * Class Sms
 *
 * @author toplan<[email protected]>
 */
class Sms
{
    const TYPE_SMS = 1;
    const TYPE_VOICE = 2;

    /**
     * Task instance.
     *
     * @var Task
     */
    protected static $task = null;

    /**
     * Agent instances.
     *
     * @var Agent[]
     */
    protected static $agents = [];

    /**
     * Dispatch scheme of agents.
     *
     * @var array
     */
    protected static $scheme = [];

    /**
     * Configuration information of agents.
     *
     * @var array
     */
    protected static $agentsConfig = [];

    /**
     * Whether to use the queue system.
     *
     * @var bool
     */
    protected static $enableQueue = false;

    /**
     * How to use the queue system.
     *
     * @var \Closure
     */
    protected static $howToUseQueue = null;

    /**
     * Available hooks.
     *
     * @var string[]
     */
    protected static $availableHooks = [
        'beforeRun',
        'beforeDriverRun',
        'afterDriverRun',
        'afterRun',
    ];

    /**
     * Data container.
     *
     * @var array
     */
    protected $smsData = [
        'type'      => self::TYPE_SMS,
        'to'        => null,
        'templates' => [],
        'data'      => [],
        'content'   => null,
        'code'      => null,
        'files'     => [],
        'params'    => [],
    ];

    /**
     * The name of first agent.
     *
     * @var string
     */
    protected $firstAgent = null;

    /**
     * Whether pushed to the queue system.
     *
     * @var bool
     */
    protected $pushedToQueue = false;

    /**
     * State container.
     *
     * @var array
     */
    protected $state = [];

    /**
     * Constructor
     *
     * @param bool $autoBoot
     */
    public function __construct($autoBoot = true)
    {
        if ($autoBoot) {
            self::bootTask();
        }
    }

    /**
     * Bootstrap the task.
     */
    public static function bootTask()
    {
        if (!self::isTaskBooted()) {
            self::configure();
            foreach (self::scheme() as $name => $scheme) {
                self::registerDriver($name, $scheme);
            }
        }
    }

    /**
     * Is task has been booted.
     *
     * @return bool
     */
    protected static function isTaskBooted()
    {
        return !empty(self::getTask()->drivers);
    }

    /**
     * Get the task instance.
     *
     * @return Task
     */
    public static function getTask()
    {
        if (empty(self::$task)) {
            self::$task = new Task();
        }

        return self::$task;
    }

    /**
     * Configure.
     *
     * @throws PhpSmsException
     */
    protected static function configure()
    {
        $config = [];
        if (!count(self::scheme())) {
            self::initScheme($config);
        }
        $diff = array_diff_key(self::scheme(), self::$agentsConfig);
        self::initAgentsConfig(array_keys($diff), $config);
        if (!count(self::scheme())) {
            throw new PhpSmsException('Expected at least one agent in scheme.');
        }
    }

    /**
     * Initialize the dispatch scheme.
     *
     * @param array $config
     */
    protected static function initScheme(array &$config)
    {
        $config = empty($config) ? include __DIR__ . '/../config/phpsms.php' : $config;
        $scheme = isset($config['scheme']) ? $config['scheme'] : [];
        self::scheme($scheme);
    }

    /**
     * Initialize the configuration information.
     *
     * @param array $agents
     * @param array $config
     */
    protected static function initAgentsConfig(array $agents, array &$config)
    {
        if (empty($agents)) {
            return;
        }
        $config = empty($config) ? include __DIR__ . '/../config/phpsms.php' : $config;
        $agentsConfig = isset($config['agents']) ? $config['agents'] : [];
        foreach ($agents as $name) {
            $agentConfig = isset($agentsConfig[$name]) ? $agentsConfig[$name] : [];
            self::config($name, $agentConfig);
        }
    }

    /**
     * register driver.
     *
     * @param string       $name
     * @param string|array $scheme
     */
    protected static function registerDriver($name, $scheme)
    {
        // parse higher-order scheme
        $settings = [];
        if (is_array($scheme)) {
            $settings = self::parseScheme($scheme);
            $scheme = $settings['scheme'];
        }
        // register
        self::getTask()->driver("$name $scheme")->work(function (Driver $driver) use ($settings) {
            $agent = self::getAgent($driver->name, $settings);
            extract($driver->getTaskData());

            $template = isset($templates[$driver->name]) ? $templates[$driver->name] : null;
            $file = isset($files[$driver->name]) ? $files[$driver->name] : null;
            $params = isset($params[$driver->name]) ? $params[$driver->name] : [];
            if ($type === self::TYPE_VOICE) {
                $agent->sendVoice($to, $content, $template, $data, $code, $file, $params);
            } elseif ($type === self::TYPE_SMS) {
                $agent->sendSms($to, $content, $template, $data, $params);
            }
            $result = $agent->result();
            if ($result['success']) {
                $driver->success();
            }
            unset($result['success']);

            return $result;
        });
    }

    /**
     * Parse the higher-order dispatch scheme.
     *
     * @param array $options
     *
     * @return array
     */
    protected static function parseScheme(array $options)
    {
        $weight = Util::pullFromArray($options, 'weight');
        $backup = Util::pullFromArray($options, 'backup') ? 'backup' : '';
        $props = array_filter(array_values($options), function ($prop) {
            return is_numeric($prop) || is_string($prop);
        });

        $options['scheme'] = implode(' ', $props) . " $weight $backup";

        return $options;
    }

    /**
     * Get the agent instance by name.
     *
     * @param string $name
     * @param array  $options
     *
     * @throws PhpSmsException
     *
     * @return Agent
     */
    public static function getAgent($name, array $options = [])
    {
        if (!self::hasAgent($name)) {
            $scheme = self::scheme($name);
            $config = self::config($name);
            if (is_array($scheme) && empty($options)) {
                $options = self::parseScheme($scheme);
            }
            if (isset($options['scheme'])) {
                unset($options['scheme']);
            }
            $className = "Toplan\\PhpSms\\{$name}Agent";
            if (isset($options['agentClass'])) {
                $className = $options['agentClass'];
                unset($options['agentClass']);
            }
            if (!empty($options)) {
                self::$agents[$name] = new ParasiticAgent($config, $options);
            } elseif (class_exists($className)) {
                self::$agents[$name] = new $className($config);
            } else {
                throw new PhpSmsException("Not support agent `$name`.");
            }
        }

        return self::$agents[$name];
    }

    /**
     * Whether has the specified agent.
     *
     * @param string $name
     *
     * @return bool
     */
    public static function hasAgent($name)
    {
        return isset(self::$agents[$name]);
    }

    /**
     * Set or get the dispatch scheme.
     *
     * @param string|array|null      $name
     * @param string|array|bool|null $scheme
     * @param bool                   $override
     *
     * @return mixed
     */
    public static function scheme($name = null, $scheme = null, $override = false)
    {
        if (is_array($name) && is_bool($scheme)) {
            $override = $scheme;
        }

        return Util::operateArray(self::$scheme, $name, $scheme, null, function ($key, $value) {
            if (is_string($key)) {
                self::modifyScheme($key, is_array($value) ? $value : "$value");
            } elseif (is_int($key)) {
                self::modifyScheme($value, '');
            }
        }, $override, function (array $origin) {
            if (self::isTaskBooted()) {
                foreach (array_keys($origin) as $name) {
                    self::getTask()->removeDriver($name);
                }
            }
        });
    }

    /**
     * Modify the dispatch scheme of agent.
     *
     * @param string       $name
     * @param string|array $scheme
     *
     * @throws PhpSmsException
     */
    protected static function modifyScheme($name, $scheme)
    {
        self::validateAgentName($name);
        self::$scheme[$name] = $scheme;
        if (self::isTaskBooted()) {
            $driver = self::getTask()->getDriver($name);
            if ($driver) {
                if (is_array($scheme)) {
                    $higherOrderScheme = self::parseScheme($scheme);
                    $scheme = $higherOrderScheme['scheme'];
                }
                $driver->reset($scheme);
            } else {
                self::registerDriver($name, $scheme);
            }
        }
    }

    /**
     * Set or get the configuration information.
     *
     * @param string|array|null $name
     * @param array|bool|null   $config
     * @param bool              $override
     *
     * @throws PhpSmsException
     *
     * @return array
     */
    public static function config($name = null, $config = null, $override = false)
    {
        $overrideAll = (is_array($name) && is_bool($config)) ? $config : false;

        return Util::operateArray(self::$agentsConfig, $name, $config, [], function ($name, array $config) use ($override) {
            self::modifyConfig($name, $config, $override);
        }, $overrideAll, function (array $origin) {
            foreach (array_keys($origin) as $name) {
                if (self::hasAgent("$name")) {
                    self::getAgent("$name")->config([], true);
                }
            }
        });
    }

    /**
     * Modify the configuration information.
     *
     * @param string $name
     * @param array  $config
     * @param bool   $override
     *
     * @throws PhpSmsException
     */
    protected static function modifyConfig($name, array $config, $override = false)
    {
        self::validateAgentName($name);
        if (!isset(self::$agentsConfig[$name])) {
            self::$agentsConfig[$name] = [];
        }
        $target = &self::$agentsConfig[$name];
        if ($override) {
            $target = $config;
        } else {
            $target = array_merge($target, $config);
        }
        if (self::hasAgent($name)) {
            self::getAgent($name)->config($target);
        }
    }

    /**
     * Validate the name of agent.
     *
     * @param string $name
     *
     * @throws PhpSmsException
     */
    protected static function validateAgentName($name)
    {
        if (empty($name) || !is_string($name) || preg_match('/^[0-9]+$/', $name)) {
            throw new PhpSmsException('Expected the name of agent to be a string which except the digital string.');
        }
    }

    /**
     * Tear down scheme.
     */
    public static function cleanScheme()
    {
        self::scheme([], true);
    }

    /**
     * Tear down config information.
     */
    public static function cleanConfig()
    {
        self::config([], true);
    }

    /**
     * Create a instance for send sms.
     *
     * @param mixed $agentName
     * @param mixed $tempId
     *
     * @return Sms
     */
    public static function make($agentName = null, $tempId = null)
    {
        $sms = new self();
        $sms->type(self::TYPE_SMS);
        if (is_array($agentName)) {
            $sms->template($agentName);
        } elseif ($agentName && is_string($agentName)) {
            if ($tempId === null) {
                $sms->content($agentName);
            } elseif (is_string($tempId) || is_int($tempId)) {
                $sms->template($agentName, "$tempId");
            }
        }

        return $sms;
    }

    /**
     * Create a instance for send voice.
     *
     * @param int|string|null $code
     *
     * @return Sms
     */
    public static function voice($code = null)
    {
        $sms = new self();
        $sms->type(self::TYPE_VOICE);
        $sms->code($code);

        return $sms;
    }

    /**
     * Set whether to use the queue system,
     * and define how to use it.
     *
     * @param bool|\Closure|null $enable
     * @param \Closure|null      $handler
     *
     * @return bool
     */
    public static function queue($enable = null, $handler = null)
    {
        if ($enable === null && $handler === null) {
            return self::$enableQueue;
        }
        if (is_callable($enable)) {
            $handler = $enable;
            $enable = true;
        }
        self::$enableQueue = (bool) $enable;
        if (is_callable($handler)) {
            self::$howToUseQueue = $handler;
        }

        return self::$enableQueue;
    }

    /**
     * Set the type of Sms instance.
     *
     * @param $type
     *
     * @throws PhpSmsException
     *
     * @return $this
     */
    public function type($type)
    {
        if ($type !== self::TYPE_SMS && $type !== self::TYPE_VOICE) {
            throw new PhpSmsException('Expected the parameter equals to `Sms::TYPE_SMS` or `Sms::TYPE_VOICE`.');
        }
        $this->smsData['type'] = $type;

        return $this;
    }

    /**
     * Set the recipient`s mobile number.
     *
     * @param string|array $mobile
     *
     * @return $this
     */
    public function to($mobile)
    {
        if (is_string($mobile)) {
            $mobile = trim($mobile);
        }
        $this->smsData['to'] = $mobile;

        return $this;
    }

    /**
     * Set the sms content.
     *
     * @param string $content
     *
     * @return $this
     */
    public function content($content)
    {
        $this->smsData['content'] = trim((string) $content);

        return $this;
    }

    /**
     * Set the template ids.
     *
     * @param mixed $name
     * @param mixed $tempId
     *
     * @return $this
     */
    public function template($name, $tempId = null)
    {
        Util::operateArray($this->smsData['templates'], $name, $tempId);

        return $this;
    }

    /**
     * Set the template data.
     *
     * @param mixed $key
     * @param mixed $value
     *
     * @return $this
     */
    public function data($key, $value = null)
    {
        Util::operateArray($this->smsData['data'], $key, $value);

        return $this;
    }

    /**
     * Set the voice code.
     *
     * @param string|int $code
     *
     * @return $this
     */
    public function code($code)
    {
        $this->smsData['code'] = $code;

        return $this;
    }

    /**
     * Set voice file.
     *
     * @param string|array $name
     * @param string|int   $id
     *
     * @return $this
     */
    public function file($name, $id = null)
    {
        Util::operateArray($this->smsData['files'], $name, $id);

        return $this;
    }

    /**
     * Set params of agent.
     *
     * @param string|array    $name
     * @param array|bool|null $params
     * @param bool            $override
     *
     * @return $this
     */
    public function params($name, $params = null, $override = false)
    {
        $overrideAll = (is_array($name) && is_bool($params)) ? $params : false;
        Util::operateArray($this->smsData['params'], $name, $params, [], function ($name, array $params) use ($override) {
            if (!isset($this->smsData['params'][$name])) {
                $this->smsData['params'][$name] = [];
            }
            $target = &$this->smsData['params'][$name];
            if ($override) {
                $target = $params;
            } else {
                $target = array_merge($target, $params);
            }
        }, $overrideAll);

        return $this;
    }

    /**
     * Set the first agent.
     *
     * @param string $name
     *
     * @throws PhpSmsException
     *
     * @return $this
     */
    public function agent($name)
    {
        if (!is_string($name) || empty($name)) {
            throw new PhpSmsException('Expected the parameter to be non-empty string.');
        }
        $this->firstAgent = $name;

        return $this;
    }

    /**
     * Start send.
     *
     * If call with a `true` parameter, this system will immediately start request to send sms whatever whether to use the queue.
     * if the current instance has pushed to the queue, you can recall this method in queue system without any parameter,
     * so this mechanism in order to make you convenient to use this method in queue system.
     *
     * @param bool $immediately
     *
     * @return mixed
     */
    public function send($immediately = false)
    {
        if (!self::$enableQueue || $this->pushedToQueue) {
            $immediately = true;
        }
        if ($immediately) {
            return self::$task->data($this->all())->run($this->firstAgent);
        }

        return $this->push();
    }

    /**
     * Push to the queue system.
     *
     * @throws \Exception | PhpSmsException
     *
     * @return mixed
     */
    public function push()
    {
        if (!is_callable(self::$howToUseQueue)) {
            throw new PhpSmsException('Expected define how to use the queue system by methods `queue`.');
        }
        try {
            $this->pushedToQueue = true;

            return call_user_func_array(self::$howToUseQueue, [$this, $this->all()]);
        } catch (\Exception $e) {
            $this->pushedToQueue = false;
            throw $e;
        }
    }

    /**
     * Get all of the data.
     *
     * @param null|string $key
     *
     * @return mixed
     */
    public function all($key = null)
    {
        if ($key !== null) {
            return isset($this->smsData[$key]) ? $this->smsData[$key] : null;
        }

        return $this->smsData;
    }

    /**
     * Define the static hook methods by overload static method.
     *
     * @param string $name
     * @param array  $args
     *
     * @throws PhpSmsException
     */
    public static function __callStatic($name, $args)
    {
        $name = $name === 'beforeSend' ? 'beforeRun' : $name;
        $name = $name === 'afterSend' ? 'afterRun' : $name;
        $name = $name === 'beforeAgentSend' ? 'beforeDriverRun' : $name;
        $name = $name === 'afterAgentSend' ? 'afterDriverRun' : $name;
        if (!in_array($name, self::$availableHooks)) {
            throw new PhpSmsException("Not found methods `$name`.");
        }
        $handler = $args[0];
        $override = isset($args[1]) ? (bool) $args[1] : false;
        self::getTask()->hook($name, $handler, $override);
    }

    /**
     * Define the hook methods by overload method.
     *
     * @param string $name
     * @param array  $args
     *
     * @throws PhpSmsException
     * @throws \Exception
     */
    public function __call($name, $args)
    {
        try {
            $this->__callStatic($name, $args);
        } catch (\Exception $e) {
            throw $e;
        }
    }

    /**
     * Serialize magic method.
     *
     * @return array
     */
    public function __sleep()
    {
        try {
            $this->state['scheme'] = self::toggleSerializeScheme(self::scheme());
            $this->state['agentsConfig'] = self::config();
            $this->state['handlers'] = self::serializeHandlers();
        } catch (\Exception $e) {
            //swallow exception
        }

        return ['smsData', 'firstAgent', 'pushedToQueue', 'state'];
    }

    /**
     * Deserialize magic method.
     */
    public function __wakeup()
    {
        if (empty($this->state)) {
            return;
        }
        self::$scheme = self::toggleSerializeScheme($this->state['scheme']);
        self::$agentsConfig = $this->state['agentsConfig'];
        self::reinstallHandlers($this->state['handlers']);
    }

    /**
     * Serialize or deserialize the scheme.
     *
     * @param array $scheme
     *
     * @return array
     */
    protected static function toggleSerializeScheme(array $scheme)
    {
        foreach ($scheme as $name => &$options) {
            if (is_array($options)) {
                foreach (ParasiticAgent::methods() as $method) {
                    self::toggleSerializeClosure($options, $method);
                }
            }
        }

        return $scheme;
    }

    /**
     * Serialize the hooks' handlers.
     *
     * @return array
     */
    protected static function serializeHandlers()
    {
        $hooks = (array) self::getTask()->handlers;
        foreach ($hooks as &$handlers) {
            foreach (array_keys($handlers) as $key) {
                self::toggleSerializeClosure($handlers, $key);
            }
        }

        return $hooks;
    }

    /**
     * Reinstall hooks' handlers.
     *
     * @param array $handlers
     */
    protected static function reinstallHandlers(array $handlers)
    {
        $serializer = Util::getClosureSerializer();
        foreach ($handlers as $hookName => $serializedHandlers) {
            foreach ($serializedHandlers as $index => $handler) {
                if (is_string($handler)) {
                    $handler = $serializer->unserialize($handler);
                }
                self::$hookName($handler, $index === 0);
            }
        }
    }

    /**
     * Serialize or deserialize the specified closure and then replace the original value.
     *
     * @param array      $options
     * @param int|string $key
     */
    protected static function toggleSerializeClosure(array &$options, $key)
    {
        if (!isset($options[$key])) {
            return;
        }
        $serializer = Util::getClosureSerializer();
        if (is_callable($options[$key])) {
            $options[$key] = (string) $serializer->serialize($options[$key]);
        } elseif (is_string($options[$key])) {
            $options[$key] = $serializer->unserialize($options[$key]);
        }
    }
}


1		<?php
2
3		namespace Toplan\PhpSms;
4
5		use Toplan\TaskBalance\Driver;
6		use Toplan\TaskBalance\Task;
7
8		/**
9		* Class Sms
10		*
11		* @author toplan<[email protected]>
12		*/
13		class Sms
14		{
15		const TYPE_SMS = 1;
16		const TYPE_VOICE = 2;
17
18		/**
19		* Task instance.
20		*
21		* @var Task
22		*/
23		protected static $task = null;
24
25		/**
26		* Agent instances.
27		*
28		* @var Agent[]
29		*/
30		protected static $agents = [];
31
32		/**
33		* Dispatch scheme of agents.
34		*
35		* @var array
36		*/
37		protected static $scheme = [];
38
39		/**
40		* Configuration information of agents.
41		*
42		* @var array
43		*/
44		protected static $agentsConfig = [];
45
46		/**
47		* Whether to use the queue system.
48		*
49		* @var bool
50		*/
51		protected static $enableQueue = false;
52
53		/**
54		* How to use the queue system.
55		*
56		* @var \Closure
57		*/
58		protected static $howToUseQueue = null;
59
60		/**
61		* Available hooks.
62		*
63		* @var string[]
64		*/
65		protected static $availableHooks = [
66		'beforeRun',
67		'beforeDriverRun',
68		'afterDriverRun',
69		'afterRun',
70		];
71
72		/**
73		* Data container.
74		*
75		* @var array
76		*/
77		protected $smsData = [
78		'type' => self::TYPE_SMS,
79		'to' => null,
80		'templates' => [],
81		'data' => [],
82		'content' => null,
83		'code' => null,
84		'files' => [],
85		'params' => [],
86		];
87
88		/**
89		* The name of first agent.
90		*
91		* @var string
92		*/
93		protected $firstAgent = null;
94
95		/**
96		* Whether pushed to the queue system.
97		*
98		* @var bool
99		*/
100		protected $pushedToQueue = false;
101
102		/**
103		* State container.
104		*
105		* @var array
106		*/
107		protected $state = [];
108
109		/**
110		* Constructor
111		*
112		* @param bool $autoBoot
113		*/
114	6	public function __construct($autoBoot = true)
115		{
116	6	if ($autoBoot) {
117	3	self::bootTask();
118	2	}
119	6	}
120
121		/**
122		* Bootstrap the task.
123		*/
124	3	public static function bootTask()
125		{
126	3	if (!self::isTaskBooted()) {
127		self::configure();
128		foreach (self::scheme() as $name => $scheme) {
129		self::registerDriver($name, $scheme);
130		}
131		}
132	3	}
133
134		/**
135		* Is task has been booted.
136		*
137		* @return bool
138		*/
139	15	protected static function isTaskBooted()
140		{
141	15	return !empty(self::getTask()->drivers);
142		}
143
144		/**
145		* Get the task instance.
146		*
147		* @return Task
148		*/
149	24	public static function getTask()
150		{
151	24	if (empty(self::$task)) {
152	3	self::$task = new Task();
153	2	}
154
155	24	return self::$task;
156		}
157
158		/**
159		* Configure.
160		*
161		* @throws PhpSmsException
162		*/
163	3	protected static function configure()
164		{
165	3	$config = [];
166	3	if (!count(self::scheme())) {
167	3	self::initScheme($config);
168	2	}
169	3	$diff = array_diff_key(self::scheme(), self::$agentsConfig);
170	3	self::initAgentsConfig(array_keys($diff), $config);
171	3	if (!count(self::scheme())) {
172		throw new PhpSmsException('Expected at least one agent in scheme.');
173		}
174	3	}
175
176		/**
177		* Initialize the dispatch scheme.
178		*
179		* @param array $config
180		*/
181	3	protected static function initScheme(array &$config)
182		{
183	3	$config = empty($config) ? include __DIR__ . '/../config/phpsms.php' : $config;
184	3	$scheme = isset($config['scheme']) ? $config['scheme'] : [];
185	3	self::scheme($scheme);
186	3	}
187
188		/**
189		* Initialize the configuration information.
190		*
191		* @param array $agents
192		* @param array $config
193		*/
194	3	protected static function initAgentsConfig(array $agents, array &$config)
195		{
196	3	if (empty($agents)) {
197		return;
198		}
199	3	$config = empty($config) ? include __DIR__ . '/../config/phpsms.php' : $config;
200	3	$agentsConfig = isset($config['agents']) ? $config['agents'] : [];
201	3	foreach ($agents as $name) {
202	3	$agentConfig = isset($agentsConfig[$name]) ? $agentsConfig[$name] : [];
203	3	self::config($name, $agentConfig);
204	2	}
205	3	}
206
207		/**
208		* register driver.
209		*
210		* @param string $name
211		* @param string\|array $scheme
212		*/
213	15	protected static function registerDriver($name, $scheme)
214		{
215		// parse higher-order scheme
216		$settings = [];
217		if (is_array($scheme)) {
218		$settings = self::parseScheme($scheme);
219		$scheme = $settings['scheme'];
220		}
221		// register
222		self::getTask()->driver("$name $scheme")->work(function (Driver $driver) use ($settings) {
223	15	$agent = self::getAgent($driver->name, $settings);
224	15	extract($driver->getTaskData());
		0 ignored issues – show Bug introduced 2017-05-16 15:53 UTC by Report Bug Copy Issue Report `$driver->getTaskData()` cannot be passed to `extract()` as the parameter `$var_array` expects a reference. Loading history...
225	15	$template = isset($templates[$driver->name]) ? $templates[$driver->name] : null;
226	15	$file = isset($files[$driver->name]) ? $files[$driver->name] : null;
227	15	$params = isset($params[$driver->name]) ? $params[$driver->name] : [];
228	15	if ($type === self::TYPE_VOICE) {
229		$agent->sendVoice($to, $content, $template, $data, $code, $file, $params);
230	15	} elseif ($type === self::TYPE_SMS) {
231	15	$agent->sendSms($to, $content, $template, $data, $params);
232	10	}
233	15	$result = $agent->result();
234	15	if ($result['success']) {
235	15	$driver->success();
236	10	}
237	15	unset($result['success']);
238
239	15	return $result;
240		});
241		}
242
243		/**
244		* Parse the higher-order dispatch scheme.
245		*
246		* @param array $options
247		*
248		* @return array
249		*/
250		protected static function parseScheme(array $options)
251		{
252		$weight = Util::pullFromArray($options, 'weight');
253		$backup = Util::pullFromArray($options, 'backup') ? 'backup' : '';
254		$props = array_filter(array_values($options), function ($prop) {
255		return is_numeric($prop) \|\| is_string($prop);
256		});
257
258		$options['scheme'] = implode(' ', $props) . " $weight $backup";
259
260		return $options;
261		}
262
263		/**
264		* Get the agent instance by name.
265		*
266		* @param string $name
267		* @param array $options
268		*
269		* @throws PhpSmsException
270		*
271		* @return Agent
272		*/
273	24	public static function getAgent($name, array $options = [])
274		{
275	24	if (!self::hasAgent($name)) {
276	6	$scheme = self::scheme($name);
277	6	$config = self::config($name);
278	6	if (is_array($scheme) && empty($options)) {
279		$options = self::parseScheme($scheme);
280		}
281	6	if (isset($options['scheme'])) {
282		unset($options['scheme']);
283		}
284	6	$className = "Toplan\\PhpSms\\{$name}Agent";
285	6	if (isset($options['agentClass'])) {
286		$className = $options['agentClass'];
287		unset($options['agentClass']);
288		}
289	16	if (!empty($options)) {
290		self::$agents[$name] = new ParasiticAgent($config, $options);
291	6	} elseif (class_exists($className)) {
292	6	self::$agents[$name] = new $className($config);
293	4	} else {
294		throw new PhpSmsException("Not support agent `$name`.");
295		}
296	4	}
297
298	24	return self::$agents[$name];
299		}
300
301		/**
302		* Whether has the specified agent.
303		*
304		* @param string $name
305		*
306		* @return bool
307		*/
308	33	public static function hasAgent($name)
309		{
310	33	return isset(self::$agents[$name]);
311		}
312
313		/**
314		* Set or get the dispatch scheme.
315		*
316		* @param string\|array\|null $name
317		* @param string\|array\|bool\|null $scheme
318		* @param bool $override
319		*
320		* @return mixed
321		*/
322	18	public static function scheme($name = null, $scheme = null, $override = false)
323		{
324	18	if (is_array($name) && is_bool($scheme)) {
325	6	$override = $scheme;
326	4	}
327
328		return Util::operateArray(self::$scheme, $name, $scheme, null, function ($key, $value) {
329	6	if (is_string($key)) {
330	3	self::modifyScheme($key, is_array($value) ? $value : "$value");
331	6	} elseif (is_int($key)) {
332	6	self::modifyScheme($value, '');
333	4	}
334		}, $override, function (array $origin) {
335	6	if (self::isTaskBooted()) {
336	3	foreach (array_keys($origin) as $name) {
337	3	self::getTask()->removeDriver($name);
338	2	}
339	2	}
340	18	});
341		}
342
343		/**
344		* Modify the dispatch scheme of agent.
345		*
346		* @param string $name
347		* @param string\|array $scheme
348		*
349		* @throws PhpSmsException
350		*/
351	6	protected static function modifyScheme($name, $scheme)
352		{
353	6	self::validateAgentName($name);
354	6	self::$scheme[$name] = $scheme;
355	6	if (self::isTaskBooted()) {
356		$driver = self::getTask()->getDriver($name);
357		if ($driver) {
358		if (is_array($scheme)) {
359		$higherOrderScheme = self::parseScheme($scheme);
360		$scheme = $higherOrderScheme['scheme'];
361		}
362		$driver->reset($scheme);
363		} else {
364		self::registerDriver($name, $scheme);
365		}
366		}
367	6	}
368
369		/**
370		* Set or get the configuration information.
371		*
372		* @param string\|array\|null $name
373		* @param array\|bool\|null $config
374		* @param bool $override
375		*
376		* @throws PhpSmsException
377		*
378		* @return array
379		*/
380	18	public static function config($name = null, $config = null, $override = false)
381		{
382	18	$overrideAll = (is_array($name) && is_bool($config)) ? $config : false;
383
384		return Util::operateArray(self::$agentsConfig, $name, $config, [], function ($name, array $config) use ($override) {
385	9	self::modifyConfig($name, $config, $override);
386		}, $overrideAll, function (array $origin) {
387	6	foreach (array_keys($origin) as $name) {
388	6	if (self::hasAgent("$name")) {
389	4	self::getAgent("$name")->config([], true);
390	2	}
391	4	}
392	18	});
393		}
394
395		/**
396		* Modify the configuration information.
397		*
398		* @param string $name
399		* @param array $config
400		* @param bool $override
401		*
402		* @throws PhpSmsException
403		*/
404	9	protected static function modifyConfig($name, array $config, $override = false)
405		{
406	9	self::validateAgentName($name);
407	9	if (!isset(self::$agentsConfig[$name])) {
408	6	self::$agentsConfig[$name] = [];
409	4	}
410	9	$target = &self::$agentsConfig[$name];
411	9	if ($override) {
412		$target = $config;
413		} else {
414	9	$target = array_merge($target, $config);
415		}
416	9	if (self::hasAgent($name)) {
417	3	self::getAgent($name)->config($target);
418	2	}
419	9	}
420
421		/**
422		* Validate the name of agent.
423		*
424		* @param string $name
425		*
426		* @throws PhpSmsException
427		*/
428	12	protected static function validateAgentName($name)
429		{
430	12	if (empty($name) \|\| !is_string($name) \|\| preg_match('/^[0-9]+$/', $name)) {
431		throw new PhpSmsException('Expected the name of agent to be a string which except the digital string.');
432		}
433	12	}
434
435		/**
436		* Tear down scheme.
437		*/
438	6	public static function cleanScheme()
439		{
440	6	self::scheme([], true);
441	6	}
442
443		/**
444		* Tear down config information.
445		*/
446	6	public static function cleanConfig()
447		{
448	6	self::config([], true);
449	6	}
450
451		/**
452		* Create a instance for send sms.
453		*
454		* @param mixed $agentName
455		* @param mixed $tempId
456		*
457		* @return Sms
458		*/
459		public static function make($agentName = null, $tempId = null)
460		{
461		$sms = new self();
462		$sms->type(self::TYPE_SMS);
463		if (is_array($agentName)) {
464		$sms->template($agentName);
465		} elseif ($agentName && is_string($agentName)) {
466		if ($tempId === null) {
467		$sms->content($agentName);
468		} elseif (is_string($tempId) \|\| is_int($tempId)) {
469		$sms->template($agentName, "$tempId");
470		}
471		}
472
473		return $sms;
474		}
475
476		/**
477		* Create a instance for send voice.
478		*
479		* @param int\|string\|null $code
480		*
481		* @return Sms
482		*/
483	3	public static function voice($code = null)
484		{
485	3	$sms = new self();
486	3	$sms->type(self::TYPE_VOICE);
487	3	$sms->code($code);
488
489	3	return $sms;
490		}
491
492		/**
493		* Set whether to use the queue system,
494		* and define how to use it.
495		*
496		* @param bool\|\Closure\|null $enable
497		* @param \Closure\|null $handler
498		*
499		* @return bool
500		*/
501	3	public static function queue($enable = null, $handler = null)
502		{
503	3	if ($enable === null && $handler === null) {
504	3	return self::$enableQueue;
505		}
506	3	if (is_callable($enable)) {
507	3	$handler = $enable;
508	3	$enable = true;
509	2	}
510	3	self::$enableQueue = (bool) $enable;
511	3	if (is_callable($handler)) {
512	3	self::$howToUseQueue = $handler;
513	2	}
514
515	3	return self::$enableQueue;
516		}
517
518		/**
519		* Set the type of Sms instance.
520		*
521		* @param $type
522		*
523		* @throws PhpSmsException
524		*
525		* @return $this
526		*/
527	3	public function type($type)
528		{
529	3	if ($type !== self::TYPE_SMS && $type !== self::TYPE_VOICE) {
530		throw new PhpSmsException('Expected the parameter equals to `Sms::TYPE_SMS` or `Sms::TYPE_VOICE`.');
531		}
532	3	$this->smsData['type'] = $type;
533
534	3	return $this;
535		}
536
537		/**
538		* Set the recipient`s mobile number.
539		*
540		* @param string\|array $mobile
541		*
542		* @return $this
543		*/
544	6	public function to($mobile)
545		{
546	6	if (is_string($mobile)) {
547	6	$mobile = trim($mobile);
548	4	}
549	6	$this->smsData['to'] = $mobile;
550
551	6	return $this;
552		}
553
554		/**
555		* Set the sms content.
556		*
557		* @param string $content
558		*
559		* @return $this
560		*/
561	3	public function content($content)
562		{
563	3	$this->smsData['content'] = trim((string) $content);
564
565	3	return $this;
566		}
567
568		/**
569		* Set the template ids.
570		*
571		* @param mixed $name
572		* @param mixed $tempId
573		*
574		* @return $this
575		*/
576	3	public function template($name, $tempId = null)
577		{
578	3	Util::operateArray($this->smsData['templates'], $name, $tempId);
579
580	3	return $this;
581		}
582
583		/**
584		* Set the template data.
585		*
586		* @param mixed $key
587		* @param mixed $value
588		*
589		* @return $this
590		*/
591	3	public function data($key, $value = null)
592		{
593	3	Util::operateArray($this->smsData['data'], $key, $value);
594
595	3	return $this;
596		}
597
598		/**
599		* Set the voice code.
600		*
601		* @param string\|int $code
602		*
603		* @return $this
604		*/
605	3	public function code($code)
606		{
607	3	$this->smsData['code'] = $code;
608
609	3	return $this;
610		}
611
612		/**
613		* Set voice file.
614		*
615		* @param string\|array $name
616		* @param string\|int $id
617		*
618		* @return $this
619		*/
620		public function file($name, $id = null)
621		{
622		Util::operateArray($this->smsData['files'], $name, $id);
623
624		return $this;
625		}
626
627		/**
628		* Set params of agent.
629		*
630		* @param string\|array $name
631		* @param array\|bool\|null $params
632		* @param bool $override
633		*
634		* @return $this
635		*/
636		public function params($name, $params = null, $override = false)
637		{
638		$overrideAll = (is_array($name) && is_bool($params)) ? $params : false;
639		Util::operateArray($this->smsData['params'], $name, $params, [], function ($name, array $params) use ($override) {
640		if (!isset($this->smsData['params'][$name])) {
641		$this->smsData['params'][$name] = [];
642		}
643		$target = &$this->smsData['params'][$name];
644		if ($override) {
645		$target = $params;
646		} else {
647		$target = array_merge($target, $params);
648		}
649		}, $overrideAll);
650
651		return $this;
652		}
653
654		/**
655		* Set the first agent.
656		*
657		* @param string $name
658		*
659		* @throws PhpSmsException
660		*
661		* @return $this
662		*/
663	3	public function agent($name)
664		{
665	3	if (!is_string($name) \|\| empty($name)) {
666		throw new PhpSmsException('Expected the parameter to be non-empty string.');
667		}
668	3	$this->firstAgent = $name;
669
670	3	return $this;
671		}
672
673		/**
674		* Start send.
675		*
676		* If call with a `true` parameter, this system will immediately start request to send sms whatever whether to use the queue.
677		* if the current instance has pushed to the queue, you can recall this method in queue system without any parameter,
678		* so this mechanism in order to make you convenient to use this method in queue system.
679		*
680		* @param bool $immediately
681		*
682		* @return mixed
683		*/
684	18	public function send($immediately = false)
685		{
686	18	if (!self::$enableQueue \|\| $this->pushedToQueue) {
687	18	$immediately = true;
688	12	}
689	18	if ($immediately) {
690	18	return self::$task->data($this->all())->run($this->firstAgent);
691		}
692
693	3	return $this->push();
694		}
695
696		/**
697		* Push to the queue system.
698		*
699		* @throws \Exception \| PhpSmsException
700		*
701		* @return mixed
702		*/
703	3	public function push()
704		{
705	3	if (!is_callable(self::$howToUseQueue)) {
706		throw new PhpSmsException('Expected define how to use the queue system by methods `queue`.');
707		}
708		try {
709	3	$this->pushedToQueue = true;
710
711	3	return call_user_func_array(self::$howToUseQueue, [$this, $this->all()]);
712		} catch (\Exception $e) {
713		$this->pushedToQueue = false;
714		throw $e;
715		}
716		}
717
718		/**
719		* Get all of the data.
720		*
721		* @param null\|string $key
722		*
723		* @return mixed
724		*/
725	36	public function all($key = null)
726		{
727	36	if ($key !== null) {
728	6	return isset($this->smsData[$key]) ? $this->smsData[$key] : null;
729		}
730
731	33	return $this->smsData;
732		}
733
734		/**
735		* Define the static hook methods by overload static method.
736		*
737		* @param string $name
738		* @param array $args
739		*
740		* @throws PhpSmsException
741		*/
742	9	public static function __callStatic($name, $args)
743		{
744	9	$name = $name === 'beforeSend' ? 'beforeRun' : $name;
745	9	$name = $name === 'afterSend' ? 'afterRun' : $name;
746	9	$name = $name === 'beforeAgentSend' ? 'beforeDriverRun' : $name;
747	9	$name = $name === 'afterAgentSend' ? 'afterDriverRun' : $name;
748	9	if (!in_array($name, self::$availableHooks)) {
749		throw new PhpSmsException("Not found methods `$name`.");
750		}
751	9	$handler = $args[0];
752	9	$override = isset($args[1]) ? (bool) $args[1] : false;
753	9	self::getTask()->hook($name, $handler, $override);
754	9	}
755
756		/**
757		* Define the hook methods by overload method.
758		*
759		* @param string $name
760		* @param array $args
761		*
762		* @throws PhpSmsException
763		* @throws \Exception
764		*/
765	3	public function __call($name, $args)
766		{
767		try {
768	3	$this->__callStatic($name, $args);
769	2	} catch (\Exception $e) {
770		throw $e;
771		}
772	3	}
773
774		/**
775		* Serialize magic method.
776		*
777		* @return array
778		*/
779	3	public function __sleep()
780		{
781		try {
782	3	$this->state['scheme'] = self::toggleSerializeScheme(self::scheme());
783	3	$this->state['agentsConfig'] = self::config();
784	3	$this->state['handlers'] = self::serializeHandlers();
785	2	} catch (\Exception $e) {
786		//swallow exception
787		}
788
789	3	return ['smsData', 'firstAgent', 'pushedToQueue', 'state'];
790		}
791
792		/**
793		* Deserialize magic method.
794		*/
795	3	public function __wakeup()
796		{
797	3	if (empty($this->state)) {
798		return;
799		}
800	3	self::$scheme = self::toggleSerializeScheme($this->state['scheme']);
801	3	self::$agentsConfig = $this->state['agentsConfig'];
802	3	self::reinstallHandlers($this->state['handlers']);
803	3	}
804
805		/**
806		* Serialize or deserialize the scheme.
807		*
808		* @param array $scheme
809		*
810		* @return array
811		*/
812	3	protected static function toggleSerializeScheme(array $scheme)
813		{
814	3	foreach ($scheme as $name => &$options) {
815	3	if (is_array($options)) {
816	3	foreach (ParasiticAgent::methods() as $method) {
817	3	self::toggleSerializeClosure($options, $method);
818	2	}
819	2	}
820	2	}
821
822	3	return $scheme;
823		}
824
825		/**
826		* Serialize the hooks' handlers.
827		*
828		* @return array
829		*/
830	3	protected static function serializeHandlers()
831		{
832	3	$hooks = (array) self::getTask()->handlers;
833	3	foreach ($hooks as &$handlers) {
834	3	foreach (array_keys($handlers) as $key) {
835	3	self::toggleSerializeClosure($handlers, $key);
836	2	}
837	2	}
838
839	3	return $hooks;
840		}
841
842		/**
843		* Reinstall hooks' handlers.
844		*
845		* @param array $handlers
846		*/
847	3	protected static function reinstallHandlers(array $handlers)
848		{
849	3	$serializer = Util::getClosureSerializer();
850	3	foreach ($handlers as $hookName => $serializedHandlers) {
851	3	foreach ($serializedHandlers as $index => $handler) {
852	3	if (is_string($handler)) {
853	3	$handler = $serializer->unserialize($handler);
854	2	}
855	3	self::$hookName($handler, $index === 0);
856	2	}
857	2	}
858	3	}
859
860		/**
861		* Serialize or deserialize the specified closure and then replace the original value.
862		*
863		* @param array $options
864		* @param int\|string $key
865		*/
866	3	protected static function toggleSerializeClosure(array &$options, $key)
867		{
868	3	if (!isset($options[$key])) {
869	3	return;
870		}
871	3	$serializer = Util::getClosureSerializer();
872	3	if (is_callable($options[$key])) {
873	3	$options[$key] = (string) $serializer->serialize($options[$key]);
874	3	} elseif (is_string($options[$key])) {
875	3	$options[$key] = $serializer->unserialize($options[$key]);
876	2	}
877	3	}
878		}
879

toplan / phpsms

Push — master ( 1d8fed...863918 )

Sms::hasAgent() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like