تضيف معظم مشاريع PHP التي تتحدث مع MikroTik حزمة جاهزة. أما في Linkhive، منصتنا لفوترة مزودي الإنترنت، فقد كتبنا عميل RouterOS API PHP صغيرًا، لأن البروتوكول بسيط وكل استدعاء للراوتر يؤثر في خدمة عميل.
كلمات وجمل
تعمل الواجهة عبر TCP على المنفذ 8728 أو TLS على 8729. الأمر جملة من كلمات، وتُرسل كل كلمة مسبوقة بطولها. ويجيب الراوتر بجمل تبدأ بـ !re للصف و!trap للخطأ و!fatal عند قطع الاتصال و!done عند الانتهاء.
طريقتان لتسجيل الدخول
منذ RouterOS 6.43 يرسل الدخول الاسم وكلمة المرور مباشرة. أما الإصدارات الأقدم فتجيب بتحدٍّ، لذا يدعم العميل الطريقتين:
$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]);
}

أبقِ المشغل قابلًا للتكرار
فوق العميل يوجد مشغل بمساعد upsert واحد: يبحث عن السجل بالاسم، ويحدّثه إن وُجد، ويضيفه إن لم يوجد. لذا لا يضر تنفيذ التغيير نفسه مرتين، وهذا مهم لأن التغييرات الفاشلة تُعاد. ويتحول !trap إلى استثناء تلتقطه طبقة التزويد وتسجله وتعلّم الاشتراك لإعادة المحاولة.
أهم النقاط
- يمكن تنفيذ RouterOS API في نحو مئتي سطر.
- ادعم طريقتي الدخول إذا كان لدى عملائك راوترات أقدم.
- اجعل كل كتابة على الراوتر upsert لتكون إعادة المحاولة آمنة.
لاحظ أن عميلنا لا يتحقق من شهادة TLS للراوتر، لأن الراوترات تحمل عادة شهادات موقعة ذاتيًا. تعامل مع TLS كتشفير داخل شبكة تتحكم فيها.
شاهده في العرض التجريبي لـ Linkhive أو احصل على Linkhive من Vibe96. هل تحتاج إلى تكامل MikroTik مخصص؟ لنتحدث، أو اطلع على خدمة تطوير Laravel.