将DevExtreme数据网格的类NoSQL风格过滤条件转换为MySQL WHERE子句

我之前也碰到过类似的DevExtreme远程网格过滤转换需求，你的痛点就是把这种嵌套数组风格的NoSQL过滤规则，转换成符合MySQL语法的WHERE子句，还要严格区分字段名不带引号、值带单引号，同时处理好逻辑运算符的连接。

核心思路 #

DevExtreme的filter参数本质是一个嵌套条件数组：

• 基础条件是长度为3的三元组：[字段名, 操作符, 值]
• 复合条件是长度为3的组合结构：[左条件, 逻辑运算符(and/or), 右条件]

我们可以用递归函数来处理这种嵌套结构，分别生成对应的SQL片段，同时必须注意SQL注入的防护（这一点绝对不能忽略）。

PHP实现代码 #

function convertDevExtremeFilterToSql($filter, $dbConnection) {
    // 处理基础条件（三元组）
    if (count($filter) === 3 && is_string($filter[0]) && is_string($filter[1])) {
        $field = trim($filter[0]);
        $operator = strtoupper(trim($filter[1]));
        $value = trim($filter[2]);
        
        // 转义值防止SQL注入，这里假设用mysqli扩展，根据你的数据库扩展调整
        $escapedValue = mysqli_real_escape_string($dbConnection, $value);
        
        // 适配常见操作符，比如=、!=、LIKE等
        switch($operator) {
            case 'LIKE':
                return "$field LIKE '$escapedValue'";
            case 'CONTAINS':
                return "$field LIKE '%$escapedValue%'";
            case 'STARTSWITH':
                return "$field LIKE '$escapedValue%'";
            default:
                return "$field $operator '$escapedValue'";
        }
    }
    // 处理复合条件（逻辑连接的子条件）
    elseif (count($filter) === 3 && in_array(strtoupper($filter[1]), ['AND', 'OR'])) {
        $leftCondition = convertDevExtremeFilterToSql($filter[0], $dbConnection);
        $operator = strtoupper(trim($filter[1]));
        $rightCondition = convertDevExtremeFilterToSql($filter[2], $dbConnection);
        
        // 给子条件加括号，保证逻辑优先级正确
        return "($leftCondition) $operator ($rightCondition)";
    }
    
    // 非法过滤结构，返回空或按需抛出异常
    return '';
}

// 测试你的示例filter
$yourDbConnection = mysqli_connect('localhost', 'user', 'password', 'dbname');
$filter = [["SizeCd","=","UNIT"],"or",["SizeCd","=","JOGO"]];
$sqlWhere = convertDevExtremeFilterToSql($filter, $yourDbConnection);
echo $sqlWhere;
// 输出结果：(SizeCd = 'UNIT') OR (SizeCd = 'JOGO')

关键注意事项 #

1. SQL注入防护：必须对值进行转义，上面的代码用了mysqli_real_escape_string，如果用PDO的话，更推荐用参数绑定的方式（后面会给出示例）。
2. 操作符扩展：如果你的filter用到了contains、startswith这类DevExtreme专属操作符，需要转换成MySQL对应的LIKE语法。
3. 嵌套条件支持：递归函数可以轻松处理多层嵌套的复杂过滤，比如[["SizeCd","=","UNIT"],"and",[["StockNo",">","12000"],"or",["StockNo","<","12040"]]]这种结构。

更安全的PDO参数绑定方案 #

如果项目用PDO，建议用参数绑定替代直接拼接SQL，彻底避免SQL注入：

function convertFilterToSqlAndParams($filter, &$params = []) {
    if (count($filter) === 3 && is_string($filter[0]) && is_string($filter[1])) {
        $field = trim($filter[0]);
        $operator = strtoupper(trim($filter[1]));
        $paramKey = ':param_' . count($params);
        $params[$paramKey] = $filter[2];
        
        switch($operator) {
            case 'LIKE':
                return "$field LIKE $paramKey";
            case 'CONTAINS':
                $params[$paramKey] = "%{$filter[2]}%";
                return "$field LIKE $paramKey";
            default:
                return "$field $operator $paramKey";
        }
    } elseif (count($filter) === 3 && in_array(strtoupper($filter[1]), ['AND', 'OR'])) {
        $left = convertFilterToSqlAndParams($filter[0], $params);
        $operator = strtoupper(trim($filter[1]));
        $right = convertFilterToSqlAndParams($filter[2], $params);
        return "($left) $operator ($right)";
    }
    return '';
}

// 使用示例
$filter = [["SizeCd","=","UNIT"],"or",["SizeCd","=","JOGO"]];
$params = [];
$sqlWhere = convertFilterToSqlAndParams($filter, $params);
// SQL结果：(SizeCd = :param_0) OR (SizeCd = :param_1)
// $params数组：[':param_0' => 'UNIT', ':param_1' => 'JOGO']
// 后续用PDO预处理执行即可

内容的提问来源于stack exchange，提问作者Vivek Makwana