exceptionIfKeyNotExist(['host', 'user', 'pass'], $config); // Save config if everything is okay $this->_config = $config; // Throw error if cannot to connect if (false === $this->connect()) { throw new ClientException('Unable to connect to ' . $config->get('host') . ':' . $config->get('port')); } } /** * Check for important keys * * @param array $keys * @param ConfigInterface $config * @throws ConfigException */ private function exceptionIfKeyNotExist(array $keys, ConfigInterface $config) { $parameters = $config->getParameters(); foreach ($keys as $key) { if (!array_key_exists($key, $parameters) && isset($parameters[$key])) { throw new ConfigException("Parameter '$key' of Config is not set or empty"); } } } /** * Get some parameter from config * * @param string $parameter * @return mixed */ private function config(string $parameter) { return $this->_config->get($parameter); } /** * Encode given length in RouterOS format * * @param string $string * @return string Encoded length * @throws ClientException */ private function encodeLength(string $string): string { $length = \strlen($string); if ($length < 128) { $orig_length = $length; $offset = -1; } elseif ($length < 16384) { $orig_length = $length | 0x8000; $offset = -2; } elseif ($length < 2097152) { $orig_length = $length | 0xC00000; $offset = -3; } elseif ($length < 268435456) { $orig_length = $length | 0xE0000000; $offset = -4; } else { throw new ClientException("Unable to encode length of '$string'"); } // Pack string to binary format $result = pack('I*', $orig_length); // Parse binary string to array $result = str_split($result); // Reverse array $result = array_reverse($result); // Extract values from offset to end of array $result = \array_slice($result, $offset); // Sew items into one line $output = null; foreach ($result as $item) { $output .= $item; } return $output; } /** * Read length of line * * @param int $byte * @return int */ private function getLength(int $byte): int { // If the first bit is set then we need to remove the first four bits, shift left 8 // and then read another byte in. // We repeat this for the second and third bits. // If the fourth bit is set, we need to remove anything left in the first byte // and then read in yet another byte. if ($byte & 128) { if (($byte & 192) === 128) { $length = (($byte & 63) << 8) + \ord(fread($this->_socket, 1)); } else { if (($byte & 224) === 192) { $length = (($byte & 31) << 8) + \ord(fread($this->_socket, 1)); $length = ($length << 8) + \ord(fread($this->_socket, 1)); } else { if (($byte & 240) === 224) { $length = (($byte & 15) << 8) + \ord(fread($this->_socket, 1)); $length = ($length << 8) + \ord(fread($this->_socket, 1)); $length = ($length << 8) + \ord(fread($this->_socket, 1)); } else { $length = \ord(fread($this->_socket, 1)); $length = ($length << 8) + \ord(fread($this->_socket, 1)) * 3; $length = ($length << 8) + \ord(fread($this->_socket, 1)); $length = ($length << 8) + \ord(fread($this->_socket, 1)); } } } } else { $length = $byte; } return $length; } /** * Send write query to RouterOS (with or without tag) * * @param QueryInterface $query * @return ClientInterface * @throws ClientException */ public function write(QueryInterface $query): ClientInterface { // Send commands via loop to router foreach ($query->getQuery() as $command) { $command = trim($command); fwrite($this->_socket, $this->encodeLength($command) . $command); } // Write zero-terminator fwrite($this->_socket, \chr(0)); return $this; } /** * Read answer from server after query was executed * * @param bool $parse * @return array */ public function read(bool $parse = true): array { // By default response is empty $response = []; // Read answer from socket in loop while (true) { // Read the first byte of input which gives us some or all of the length // of the remaining reply. $byte = fread($this->_socket, 1); $length = $this->getLength(\ord($byte)); // Save only non empty strings if ($length > 0) { // Save output line to response array $response[] = stream_get_contents($this->_socket, $length); } else { // Read next line stream_get_contents($this->_socket, $length); } // If we get a !done line in response, change state of $isDone variable $isDone = ('!done' === end($response)); // Get status about latest operation $status = stream_get_meta_data($this->_socket); // If we do not have unread bytes from socket or <-same and if done, then exit from loop if ((!$status['unread_bytes']) || (!$status['unread_bytes'] && $isDone)) { break; } } // Parse results and return return $parse ? $this->parseResponse($response) : $response; } /** * Parse response from Router OS * * @param array $response Response data * @return array Array with parsed data */ private 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 (!empty($matches)) { $result['after'][$matches[1][0]] = $matches[2][0]; } } } break 2; default: $this->pregResponse($value, $matches); if (!empty($matches)) { $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 * * @return bool * @throws ClientException */ private function login(): 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')); } // Execute query and get response $response = $this->write($query)->read(false); // Return true if we have only one line from server and this line is !done return isset($response[0]) && $response[0] === '!done'; } /** * Connect to socket server * * @return bool * @throws ClientException */ 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 ($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; } /** * Save socket resource to static variable * * @param resource $socket */ private function setSocket($socket) { $this->_socket = $socket; } /** * Return socket resource if is exist * * @return resource */ public function getSocket() { return $this->_socket; } /** * Initiate socket session * * @throws ClientException */ private function openSocket() { // Default: Context for ssl $context = stream_context_create([ 'ssl' => [ 'ciphers' => 'ADH:ALL', 'verify_peer' => false, 'verify_peer_name' => false ] ]); // Default: Proto tcp:// but for ssl we need ssl:// $proto = $this->config('ssl') ? 'ssl://' : ''; // Initiate socket client $socket = @stream_socket_client( $proto . $this->config('host') . ':' . $this->config('port'), $this->_socket_err_num, $this->_socket_err_str, $this->config('timeout'), STREAM_CLIENT_CONNECT, $context ); // Throw error is socket is not initiated if (!$socket) { throw new ClientException('Unable to establish socket session, ' . $this->_socket_err_str); } // Save socket to static variable return $this->setSocket($socket); } /** * Close socket session * * @return bool */ private function closeSocket(): bool { return fclose($this->_socket); } }