sqlftw下載sqlftw源代碼下載

sqlftw

其他類別

v0.1.16

下載

sqlftw

MySQL（目前）Lexer，解析器，語言模型和靜態分析儀，用PHP編寫

它是一個驗證解析器，可為大約140個支持的SQL命令中的每一個中的每個實現對象實現對象。命令確實對SQL代碼的句法方面進行建模，而不是域的方面（完全編寫查詢的模型），但是沒有跟踪空白，目前忽略了一些註釋

該解析器旨在作為其他兩個項目的基礎：

一種是對SQL代碼進行靜態分析，尤其是遷移的安全性和性能（目前使用PHPMYADMIN項目的非常基本的SQL解析器）
有望幫助Phpstan（PHP的靜態分析工具）更好地了解SQL查詢及其結果

它本身可用於驗證SQL代碼的語法（例如遷移）

SQL語法支持：

支持從MySQL 5.X到MySQL 8.0.34的所有SQL命令以及幾乎所有語言功能

不支持的功能將無法解析：

支持ASCII不兼容的多型編碼，例如shift-jis ， gb18030或utf-16 （未能解析）
引用定界符（未實施，可能會失敗）
在ANSI模式下雙重引用名稱的隱式字符串串聯（ "foo" "bar" ；這是在字符串上支持的，但在名稱上不支持）

接受但忽略了功能（沒有模型和序列化）：

在表達式中解決操作員優先級（目前，同一層的運營商僅從左到右解析；將在稍後實施）
語句中的定期評論（收集語句之前的評論）
Heatwave插件功能（Secondary_engine）
SELECT ... PROCEDURE ANALYSE (...) - 在MySQL 8中刪除
WEIGHT_STRING(... LEVEL ...) - 在MySQL 8中刪除

除MySQL以外的方式實現了功能：

解析器在與PostgreSQL相同的未終止註釋上產生錯誤（MySQL是無聲的，並且根據測試，這可能是一個錯誤）
解析器以無效的名稱讀取用戶變量時會產生錯誤（MySQL默默地忽略它們並返回null）
解析器在使用無效的語法上產生了優化器提示的錯誤（MySQL會產生警告，AWS Aurora mysql a錯誤）

建築學：

主層：

Lexer-令牌SQL，返回一個解析器令牌的發電機
解析器（S） - 驗證語法並返回解析命令對象的生成器
命令 - 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 ...）

版本控制：

我們都喜歡語義版本，不是嗎？：]]

但是，這個圖書館是一項巨大的任務，仍在迅速的初始開發階段。即使在此階段，我也決定標記和發布版本，因為我認為它總比沒有好，而且比發布數十個alpha版本更好。因此，在我們離開“ 0.1”之前，不要期望任何向後兼容性。在第一次嘗試上設計巨大的系統是不可能的，許多概念必須安頓下來並單擊其位置，因此仍在進行許多更改

使用作曲家時，請始終將您對此軟件包的依賴性鎖定到精確版本。例如sqlftw/sqlftw:0.1.14