Skip to content

The repository is a software development kit (SDK) implemented in PHP for interacting with MikroTik RouterOS devices via their API.

License

Notifications You must be signed in to change notification settings

alvin-kiveu/MikroTik-RouterOS-Api-Php-Sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MIKROTIK - ROUTEROS - API - PHP - SDK

This PHP SDK provides a convenient interface for interacting with the Mikrotik RouterOS API. You can use this SDK to connect to a Mikrotik device, execute commands, and manage the RouterOS configuration.

Installation

This PHP SDK provides a convenient interface for interacting with the Mikrotik RouterOS API. You can use this SDK to connect to a Mikrotik device, execute commands, and manage the RouterOS configuration.

composer require ums/mikrotik

Usage

To use the SDK, create an instance of the MikrotikSdk class, and then use its methods to connect to a Mikrotik device.

use MikrotikSdk\MikrotikSdk;

$mikrotik = new MikrotikSdk;

// Connect to Mikrotik
$connect = $mikrotik->connect('192.168.88.1', 'admin', 'password');
if ($connect) {
    echo 'Connected';
} else {
    echo 'Not Connected';
}

Methods

connect($ip, $username, $password)

Connects to the Mikrotik device using the specified IP address, username, and password. Returns true on successful connection, otherwise false.

$connect = $mikrotik->connect('192.168.88.1', 'admin', 'password');

disconnect()

Disconnects from the Mikrotik device. Returns true on successful disconnection, otherwise false.

$disconnect = $mikrotik->disconnect();

Additional Methods

You can use the following methods to perform various operations on the Mikrotik device:

executeCommand($command, $param2 = true): Executes a RouterOS command. Returns true on success.

$result = $mikrotik->executeCommand('/interface/print');

sendCommand($com, $arr = array()): Sends a custom command with optional parameters. Returns the parsed response.

$response = $mikrotik->sendCommand('/ip/address/print', ['?interface' => 'ether1']);

parseResponse($response): Parses the raw response from RouterOS. Returns an array with parsed data.

$parsedData = $mikrotik->parseResponse($response);

Example

Here's a complete example demonstrating the usage of the SDK:

use MikrotikSdk\MikrotikSdk;

$mikrotik = new MikrotikSdk;

// Connect to Mikrotik
$connect = $mikrotik->connect('192.168.88.1', 'admin', 'password');
if ($connect) {
    // Execute a command
    $response = $mikrotik->sendCommand('/ip/address/print', ['?interface' => 'ether1']);
    
    // Parse and display the response
    $parsedData = $mikrotik->parseResponse($response);
    print_r($parsedData);

    // Disconnect from Mikrotik
    $mikrotik->disconnect();
} else {
    echo 'Not Connected';
}

The ip address, username, and password should be replaced with the actual values of your Mikrotik device.

License

The MIT License (MIT). Please see License File for more information.

Donate to this project

If you find this project useful, please consider making a donation. Any funds donated will be used to help further development on this project.

Donate

Credits

  • Nick Barnes

  • [Ben Menking](ben [at] infotechsc [dot] com)

  • Jeremy Jefferson

  • [Cristian Deluxe](djcristiandeluxe [at] gmail [dot] com)

  • [Mikhail Moskalev](mmv.rus [at] gmail [dot] com)

References



## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

## Donate to this project

If you find this project useful, please consider making a donation. Any funds donated will be used to help further development on this project.

[![Donate](https://img.shields.io/badge/Donate-PayStack-brightgreen)](https://paystack.com/pay/oqwdgv9xck)









About

The repository is a software development kit (SDK) implemented in PHP for interacting with MikroTik RouterOS devices via their API.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages