如何在PHP OOP动态WHERE子句构建器中实现BETWEEN操作符？

一、现有实现的问题与基础优化 #

现有代码的核心问题 #

• 未初始化参数数组：当存在过滤条件时，$params变量未提前声明，会触发PHP未定义变量警告；
• 重复键覆盖风险：多次添加同searchKey的过滤条件时，参数会被最后一次的值覆盖，导致SQL逻辑与参数不匹配；
• 操作符无校验：未限制合法操作符，传入非法值会直接导致SQL语法错误；
• 冗余WHERE子句：无过滤条件时返回WHERE 1，生成冗余SQL，不如直接返回空字符串更简洁。

基础优化后的代码（未支持BETWEEN） #

先修复上述问题，同时提升代码健壮性：

class QueryBuilder {
    private array $filters = [];
    // 定义允许的操作符列表
    private const ALLOWED_OPERATORS = ['=', '!=', '<', '>', '<=', '>=', 'LIKE'];

    public function addFilter(array $filterDetails): void
    {
        // 校验必填字段
        if (!isset($filterDetails['operator'], $filterDetails['searchKey'], $filterDetails['searchValue'])) {
            throw new InvalidArgumentException('过滤条件必须包含operator、searchKey、searchValue字段');
        }
        // 校验操作符合法性
        if (!in_array($filterDetails['operator'], self::ALLOWED_OPERATORS)) {
            throw new InvalidArgumentException('不支持的操作符：' . $filterDetails['operator']);
        }
        $this->filters[] = $filterDetails;
    }

    public function getFilters(): array
    {
        $whereClause = '';
        $params = [];

        if (!empty($this->filters)) {
            $conditions = [];
            foreach ($this->filters as $index => $filter) {
                $key = $filter['searchKey'];
                // 使用索引区分重复searchKey，避免参数覆盖
                $paramKey = ":{$key}_{$index}";
                $conditions[] = "({$key} {$filter['operator']} {$paramKey})";
                $params[$paramKey] = $filter['searchValue'];
            }
            $whereClause = ' WHERE ' . implode(' AND ', $conditions);
        }

        return [
            'whereClause' => $whereClause,
            'params' => empty($params) ? null : $params
        ];
    }
}

二、添加BETWEEN操作符支持 #

BETWEEN需要两个参数值，需针对性修改逻辑：

1. 更新允许的操作符列表，加入BETWEEN；
2. 校验BETWEEN的参数格式（searchValue必须是含两个元素的数组）；
3. 在生成WHERE子句时，创建两个参数占位符并绑定对应值。

支持BETWEEN的最终版本代码 #

class QueryBuilder {
    private array $filters = [];
    private const ALLOWED_OPERATORS = ['=', '!=', '<', '>', '<=', '>=', 'LIKE', 'BETWEEN'];

    public function addFilter(array $filterDetails): void
    {
        // 校验必填字段
        if (!isset($filterDetails['operator'], $filterDetails['searchKey'], $filterDetails['searchValue'])) {
            throw new InvalidArgumentException('过滤条件必须包含operator、searchKey、searchValue字段');
        }
        $operator = $filterDetails['operator'];
        if (!in_array($operator, self::ALLOWED_OPERATORS)) {
            throw new InvalidArgumentException('不支持的操作符：' . $operator);
        }
        // 校验BETWEEN的参数格式
        if ($operator === 'BETWEEN' && (!is_array($filterDetails['searchValue']) || count($filterDetails['searchValue']) !== 2)) {
            throw new InvalidArgumentException('BETWEEN操作符的searchValue必须是包含两个元素的数组');
        }
        $this->filters[] = $filterDetails;
    }

    public function getFilters(): array
    {
        $whereClause = '';
        $params = [];

        if (!empty($this->filters)) {
            $conditions = [];
            foreach ($this->filters as $index => $filter) {
                $key = $filter['searchKey'];
                $operator = $filter['operator'];
                
                if ($operator === 'BETWEEN') {
                    // 处理BETWEEN逻辑
                    $paramKeyStart = ":{$key}_{$index}_start";
                    $paramKeyEnd = ":{$key}_{$index}_end";
                    $conditions[] = "({$key} BETWEEN {$paramKeyStart} AND {$paramKeyEnd})";
                    $params[$paramKeyStart] = $filter['searchValue'][0];
                    $params[$paramKeyEnd] = $filter['searchValue'][1];
                } else {
                    // 普通操作符逻辑
                    $paramKey = ":{$key}_{$index}";
                    $conditions[] = "({$key} {$operator} {$paramKey})";
                    $params[$paramKey] = $filter['searchValue'];
                }
            }
            $whereClause = ' WHERE ' . implode(' AND ', $conditions);
        }

        return [
            'whereClause' => $whereClause,
            'params' => empty($params) ? null : $params
        ];
    }
}

调用示例（包含BETWEEN） #

$queryBuilder = new QueryBuilder();
$sql = "SELECT * FROM mytable";

// 添加LIKE过滤条件（通配符由调用者灵活处理）
$queryBuilder->addFilter([
    'operator' => 'LIKE',
    'searchKey' => 'name',
    'searchValue' => '%Test Name%'
]);
// 添加BETWEEN过滤条件
$queryBuilder->addFilter([
    'operator' => 'BETWEEN',
    'searchKey' => 'age',
    'searchValue' => [10, 20]
]);

$filterResult = $queryBuilder->getFilters();
echo $sql . $filterResult["whereClause"];
echo "</br>";
echo "<pre>";
print_r($filterResult["params"]);
echo "</pre>";

输出结果 #

SELECT * FROM mytable WHERE (name LIKE :name_0) AND (age BETWEEN :age_1_start AND :age_1_end)
Array
(
    [:name_0] => %Test Name%
    [:age_1_start] => 10
    [:age_1_end] => 20
)

三、进一步优化建议 #

1. 用强类型对象封装过滤条件：创建Filter类替代数组参数，提升类型安全和可读性，校验逻辑可移至该类；
2. 支持OR逻辑：添加分组嵌套或指定连接符的功能，满足复杂查询需求；
3. 处理NULL值：单独支持IS NULL/IS NOT NULL操作符，无需绑定参数；
4. 批量添加过滤条件：新增addFilters方法，支持一次性传入多个过滤条件；
5. 重置过滤条件：新增resetFilters方法，清空已添加条件，方便复用实例。

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