getParameters())) { throw new ConfigException("One or few parameters '$key' of Config is not set or empty"); } // Save config if everything is okay $this->setConfig($config); // Throw error if cannot to connect if (false === $this->connect()) { throw new ClientException('Unable to connect to ' . $config->get('host') . ':' . $config->get('port')); } } /** * Get some parameter from config * * @param string $parameter Name of required parameter * @return mixed * @throws \RouterOS\Exceptions\ConfigException */ private function config(string $parameter) { return $this->_config->get($parameter); } /** * Return socket resource if is exist * * @return \RouterOS\Config * @since 0.6 */ public function getConfig(): Config { return $this->_config; } /** * Set configuration of client * * @param \RouterOS\Config $config * @since 0.7 */ public function setConfig(Config $config) { $this->_config = $config; } /** * Send write query to RouterOS (with or without tag) * * @param string|array|\RouterOS\Query $query * @return \RouterOS\Interfaces\ClientInterface * @throws \RouterOS\Exceptions\QueryException */ public function write($query): ClientInterface { if (\is_string($query)) { $query = new Query($query); } elseif (\is_array($query)) { $endpoint = array_shift($query); $query = new Query($endpoint, $query); } if (!$query instanceof Query) { throw new QueryException('Parameters cannot be processed'); } // Send commands via loop to router foreach ($query->getQuery() as $command) { $this->_connector->writeWord(trim($command)); } // Write zero-terminator (empty string) $this->_connector->writeWord(''); return $this; } /** * Read answer from server after query was executed * * A Mikrotik reply is formed of blocks * Each block starts with a word, one of ('!re', '!trap', '!done', '!fatal') * Each block end with an zero byte (empty line) * Reply ends with a complete !done or !fatal block (ended with 'empty line') * A !fatal block precedes TCP connexion close * * @param bool $parse * @return mixed */ public function read(bool $parse = true) { // By default response is empty $response = []; // We have to wait a !done or !fatal $lastReply = false; // Read answer from socket in loop while (true) { $word = $this->_connector->readWord(); if ('' === $word) { if ($lastReply) { // We received a !done or !fatal message in a precedent loop // response is complete break; } // We did not receive the !done or !fatal message // This 0 length message is the end of a reply !re or !trap // We have to wait the router to send a !done or !fatal reply followed by optionals values and a 0 length message continue; } // Save output line to response array $response[] = $word; // If we get a !done or !fatal line in response, we are now ready to finish the read // but we need to wait a 0 length message, switch the flag if ('!done' === $word || '!fatal' === $word) { $lastReply = true; } } // Parse results and return return $parse ? $this->rosario($response) : $response; } /** * Read using Iterators to improve performance on large dataset * * @return Iterators\ResponseIterator */ public function readAsIterator() { return new Iterators\ResponseIterator($this->read(false)); } /** * This method was created by memory save reasons, it convert response * from RouterOS to readable array in safe way. * * @param array $raw Array RAW response from server * @return mixed * * Based on RouterOSResponseArray solution by @arily * * @link https://github.com/arily/RouterOSResponseArray * @since 0.10 */ private function rosario(array $raw): array { // This RAW should't be an error $positions = array_keys($raw, '!re'); $count = count($raw); $result = []; if (isset($positions[1])) { foreach ($positions as $key => $position) { // Get length of future block $length = isset($positions[$key + 1]) ? $positions[$key + 1] - $position + 1 : $count - $position; // Convert array to simple items $item = []; for ($i = 1; $i < $length; $i++) { $item[] = array_shift($raw); } // Save as result $result[] = $this->parseResponse($item)[0]; } } else { $result = $this->parseResponse($raw); } return $result; } /** * Parse response from Router OS * * @param array $response Response data * @return array Array with parsed data */ protected function parseResponse(array $response): array { $result = []; $i = -1; $lines = \count($response); foreach ($response as $key => $value) { switch ($value) { case '!re': $i++; break; case '!fatal': $result = $response; break 2; case '!trap': case '!done': // Check for =ret=, .tag and any other following messages for ($j = $key + 1; $j <= $lines; $j++) { // If we have lines after current one if (isset($response[$j])) { $this->pregResponse($response[$j], $matches); if (isset($matches[1][0], $matches[2][0])) { $result['after'][$matches[1][0]] = $matches[2][0]; } } } break 2; default: $this->pregResponse($value, $matches); if (isset($matches[1][0], $matches[2][0])) { $result[$i][$matches[1][0]] = $matches[2][0]; } break; } } return $result; } /** * Parse result from RouterOS by regular expression * * @param string $value * @param array $matches */ private function pregResponse(string $value, &$matches) { preg_match_all('/^[=|\.](.*)=(.*)/', $value, $matches); } /** * Authorization logic * * @param bool $legacyRetry Retry login if we detect legacy version of RouterOS * @return bool * @throws \RouterOS\Exceptions\ClientException * @throws \RouterOS\Exceptions\ConfigException * @throws \RouterOS\Exceptions\QueryException */ private function login(bool $legacyRetry = false): bool { // If legacy login scheme is enabled if ($this->config('legacy')) { // For the first we need get hash with salt $query = new Query('/login'); $response = $this->write($query)->read(); // Now need use this hash for authorization $query = (new Query('/login')) ->add('=name=' . $this->config('user')) ->add('=response=00' . md5(\chr(0) . $this->config('pass') . pack('H*', $response['after']['ret']))); } else { // Just login with our credentials $query = (new Query('/login')) ->add('=name=' . $this->config('user')) ->add('=password=' . $this->config('pass')); // If we set modern auth scheme but router with legacy firmware then need to retry query, // but need to prevent endless loop $legacyRetry = true; } // Execute query and get response $response = $this->write($query)->read(false); // if: // - we have more than one response // - response is '!done' // => problem with legacy version, swap it and retry // Only tested with ROS pre 6.43, will test with post 6.43 => this could make legacy parameter obsolete? if ($legacyRetry && $this->isLegacy($response)) { $this->_config->set('legacy', true); return $this->login(); } // Return true if we have only one line from server and this line is !done return (1 === count($response)) && isset($response[0]) && ($response[0] === '!done'); } /** * Detect by login request if firmware is legacy * * @param array $response * @return bool * @throws ConfigException */ private function isLegacy(array &$response): bool { return \count($response) > 1 && $response[0] === '!done' && !$this->config('legacy'); } /** * Connect to socket server * * @return bool * @throws \RouterOS\Exceptions\ClientException * @throws \RouterOS\Exceptions\ConfigException * @throws \RouterOS\Exceptions\QueryException */ private function connect(): bool { // By default we not connected $connected = false; // Few attempts in loop for ($attempt = 1; $attempt <= $this->config('attempts'); $attempt++) { // Initiate socket session $this->openSocket(); // If socket is active if (null !== $this->getSocket()) { $this->_connector = new APIConnector(new Streams\ResourceStream($this->getSocket())); // If we logged in then exit from loop if (true === $this->login()) { $connected = true; break; } // Else close socket and start from begin $this->closeSocket(); } // Sleep some time between tries sleep($this->config('delay')); } // Return status of connection return $connected; } }