Kebanyakan projek PHP yang berkomunikasi dengan MikroTik menggunakan pakej. Untuk Linkhive, platform pengebilan ISP kami, kami menulis klien API RouterOS PHP yang kecil, kerana protokolnya mudah dan setiap panggilan penghala menjejaskan perkhidmatan pelanggan.
Perkataan dan ayat
API berjalan melalui TCP pada port 8728, atau TLS pada 8729. Arahan ialah ayat yang terdiri daripada perkataan, dan setiap perkataan dihantar dengan panjangnya di hadapan. Penghala menjawab dengan ayat yang bermula dengan !re untuk baris, !trap untuk ralat, !fatal apabila memutuskan sambungan, dan !done apabila selesai.
Dua cara log masuk
Sejak RouterOS 6.43, log masuk menghantar nama dan kata laluan secara terus. Versi lama menjawab dengan cabaran, jadi klien mengendalikan kedua-duanya:
$done = $this->talk(['/login', '=name='.$username, '=password='.$password])['done'];
if (isset($done['ret'])) {
$response = '00'.md5(chr(0).$password.hex2bin($done['ret']));
$this->talk(['/login', '=name='.$username, '=response='.$response]);
}

Kekalkan pemacu idempoten
Di atas klien ada pemacu dengan satu pembantu upsert: cari rekod mengikut nama, kemas kini jika ada, tambah jika tiada. Menjalankan perubahan sama dua kali tidak mendatangkan masalah, dan ini penting kerana perubahan gagal dicuba semula. !trap menjadi pengecualian, yang ditangkap dan dilog oleh lapisan peruntukan sebelum menanda langganan untuk dicuba semula.
Perkara utama
- API RouterOS boleh dilaksanakan dalam kira-kira dua ratus baris.
- Sokong kedua-dua kaedah log masuk jika pelanggan menggunakan penghala lama.
- Jadikan setiap penulisan penghala sebagai upsert supaya cubaan semula selamat.
Perhatikan bahawa klien kami tidak mengesahkan sijil TLS penghala, kerana biasanya ia ditandatangani sendiri. Anggap TLS sebagai penyulitan pada rangkaian yang anda kawal.
Lihat dalam demo langsung Linkhive atau dapatkan Linkhive di Vibe96. Perlu integrasi MikroTik tersuai? Mari berbincang, atau lihat perkhidmatan pembangunan Laravel kami.