sqlftw

SQLFTW

MySQL (في الوقت الحالي) Lexer ، محلل ، نموذج اللغة والمحلل الثابت المكتوب في PHP

إنه محلل التحقق من صحة ينتج كائنًا يقوم بتنفيذ واجهة أمر SQLFTW SQL لكل من أوامر SQL المدعومة تقريبًا. تقوم الأوامر بنمذجة الجانب النحوي من رمز SQL ، وليس جانب المجال (النماذج بالضبط كيفية كتابة الاستعلامات) ، ومع ذلك لا تتبع المساحة البيضاء وتتجاهل حاليًا بعض التعليقات

يهدف هذا المحلل إلى أساس مشروعين آخرين:

• يقوم المرء بتحليل ثابت لرمز SQL ، وخاصة سلامة وأداء الترحيل (يستخدم حاليًا محلل SQL أساسي جدًا من مشروع PhpmyAdmin)
• آخر سوف يساعد Phpstan (أداة التحليل الثابت لـ PHP) فهم استفسارات SQL ونتائجها بشكل أفضل

من تلقاء نفسه يمكن استخدامه للتحقق من بناء جملة رمز SQL (مثل الترحيل)

دعم بناء الجملة SQL:

يدعم جميع أوامر SQL من MySQL 5.x إلى MySQL 8.0.34 وجميع ميزات اللغة تقريبًا

غير مدعوم ، ستفشل في التحليل:

• دعم الترميزات المتعددة المتوافقة مع ASCII-inconbating مثل shift-jis ، gb18030 أو utf-16 (فشل في التحليل)
• المحددات المقتبسة (لم يتم تنفيذها ، ربما سيفشل)
• تسلسل سلسلة ضمنية للأسماء المزدوجة في وضع ANSI ( "foo" "bar" ؛ هذا مدعوم على الأوتار ، ولكن ليس على الأسماء)

مقبولة ، ولكن تجاهل الميزات (لا يوجد نموذج وتسلسل):

• يتم تحليل أسبقية المشغل في التعبيرات (يتم الآن تحليل المشغلين من نفس المستوى من اليسار إلى اليمين ؛ وسيتم تنفيذها لاحقًا)
• تعليقات منتظمة داخل البيانات (التعليقات قبل جمع البيان)
• ميزات Plugin Heatwave (Secondary_Engine)
• SELECT ... PROCEDURE ANALYSE (...) - تمت إزالته في MySQL 8
• WEIGHT_STRING(... LEVEL ...) - تمت إزالته في MySQL 8

الميزات التي تم تنفيذها بطريقة أخرى غير MySQL:

• ينتج المحلل خطأ في تعليقات غير مطلوبة مثل PostgreSQL (MySQL صامت ووفقًا للاختبارات ، قد يكون هذا خطأً)
• ينتج المحلل خطأ عند قراءة متغيرات المستخدم باسم غير صالح (MySQL يتجاهلها بصمت وإرجاع خالية)
• ينتج المحللون خطأً على تلميح مُحسّن مع بناء جملة غير صالح (ينتج MySQL تحذيرًا ، AWS Aurora mysql خطأ)

بنيان:

الطبقات الرئيسية:

• Lexer - Tokenizing SQL ، إرجاع مولد من الرموز المحلل
• محلل (ق) - يتحقق من صحة بناء الجملة ويعيد مولد كائنات الأوامر المتوفرة
• الأوامر (الأوامر) - أوامر SQL تم تحليلها من نص عادي إلى تمثيل كائن غير قابل للتغيير. يمكن إعادة تسلسلها إلى نص عادي
• منصة - قوائم بالميزات التي تدعمها منصة معينة
• التنسيق - عبارات SQL القابلة للتكوين
• محلل - قواعد التحليل الثابت والأجهزة لهم

الاستخدام الأساسي:

 <?php

use ...

$platform = Platform::get(Platform::MYSQL, '8.0'); // version defaults to x.x.99 when no patch number is given
$config = new ParserConfig($platform);
$session = new Session($platform);
$parser = new Parser($config, $session);

// returns a Generator. will not parse anything if you don't iterate over it
$commands = $parser->parse('SELECT foo FROM ...');
foreach ($commands as $command) {
    // Parser does not throw exceptions. this allows to parse partially invalid code and not fail on first error
    if ($command instanceof InvalidCommand) {
        $e = $command->getException();
        ...
    }
    ...
}

الوضع الحالي للتنمية:

أين نحن الآن:

• ☑ ~ 99.9 ٪ تم تنفيذ ميزات لغة MySQL
• ☑ اختبارات الوحدة الأساسية مع التسلسل
• ☑ تم اختباره ضد عدة آلاف من الجداول والهجرة
• ☑ يخلط كل شيء تقريبًا من جناح اختبار MySQL (لا سلبيات كاذبة)
• ☑ يفشل في جميع اختبارات الخطأ تقريبًا من مجموعة اختبار MySQL (لا توجد إيجابيات كاذبة)
• ☑ اختبار التسلسل على مجموعة اختبار MySQL (جميع ميزات SQL ممثلة كما هو متوقع)
• ☐ الاختبارات المتوازية والآلية مقابل إصدارات متعددة من مجموعة اختبار MySQL
• ☐ اختبار الطفرة (التعامل مع SQL المتحور نفس DB حقيقي ؛ تمتد نطاقًا إلى ما وراء جناح اختبار MySQL)
• ☐ تمييز إصدارات النظام الأساسي (تحليل إصدار التصحيح الدقيق لخادم DB)
• ☐ نقل أدوات التحليل الثابت للهجرة إلى هذه المكتبة
• ☐ إصدار أول نسخة مستقرة؟
• ☐ منصات أخرى (Mariadb ، Sqlite ، postgresql ...)

الإصدار:

كلنا نحب النسخة الدلالية ، أليس كذلك؟ :]

لكن هذه المكتبة تعتبر مهمة ضخمة ولا تزال تمر بمرحلة تطوير أولية سريعة. لقد قررت وضع علامة وإصدار الإصدارات حتى في هذه المرحلة ، لأنني أعتقد أنها أفضل من لا شيء وأفضل من إطلاق عشرات إصدارات ألفا. لذلك لا تتوقع أي توافق متخلف حتى نترك "0.1" . من المستحيل تصميم نظام ضخم في المحاولة الأولى ، ويجب أن يستقر الكثير من المفاهيم والنقر على مكانه وبالتالي لا يزال الكثير من التغييرات قادمة

عند استخدام الملحن ، قم دائمًا بإغلاق اعتمادك على هذه الحزمة إلى إصدار دقيق. مثل sqlftw/sqlftw:0.1.14

مؤلف:

Vlasta Neubauer ، paranoiq ، https://github.com/paranoiq