PHP动态SQL与日期范围遍历技巧

在PHP开发中，我们经常会遇到需要根据一系列动态参数（例如日期范围）重复执行SQL查询的场景。传统的做法可能涉及在循环中构建SQL字符串，甚至尝试传递函数名来实现动态SQL生成。然而，这种方法往往导致代码难以维护、安全性差，并且效率低下。本教程将介绍一种更专业、更健壮的方法来处理这类问题。

避免全局变量与不当的函数调用方式

原始问题中展示了一种尝试通过 global 关键字访问数据库连接和日期变量，并通过将函数名作为参数传递来动态生成SQL的模式。这种做法存在以下几个主要问题：

1. 滥用 global 关键字：全局变量使得代码的依赖关系不明确，增加了模块间的耦合度，降低了代码的可测试性和可维护性。现代PHP开发强烈推荐使用依赖注入（将所需资源作为参数传递给函数或方法）来管理依赖。
2. 动态函数名调用：虽然PHP支持变量函数（$functionName()）或 call_user_func() 来动态调用函数，但直接将函数名作为参数传递，并期望在内部像 SQL_SELECTION($date1, $date2) 这样直接执行，与PHP的语法不符。即使能够实现，也增加了复杂性。
3. SQL注入风险：直接拼接SQL字符串（如 $sql = "SELECT '$date_till'..."）在不进行参数绑定的情况下，极易引发SQL注入漏洞。

推荐的解决方案：结构化数据与PDO预处理

为了解决上述问题，我们推荐采用以下策略：

1. 封装数据库连接：将数据库连接（通常是PDO对象）作为参数传递给执行查询的函数，而不是使用 global。
2. 结构化日期区间：将所有需要查询的日期区间预先组织成一个数组，每个元素包含一个 date_from 和 date_till。
3. 使用PDO预处理语句：对于重复执行的查询，使用PDO预处理语句可以有效防止SQL注入，并提高执行效率。

示例代码：实现动态日期范围查询

假设我们需要查询在不同日期区间内的订单数据。

首先，定义我们的日期区间数据：

setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); // 开启错误模式

// 定义需要查询的日期区间
$dateIntervals = [
    [
        'date_from' => '2019-10-29',
        'date_till' => '2020-10-28',
    ],
    [
        'date_from' => '2020-10-29',
        'date_till' => '2021-10-28',
    ],
    [
        'date_from' => '2021-10-29',
        'date_till' => '2022-10-28',
    ],
    // 更多日期区间...
];

接下来，创建一个函数来迭代这些日期区间并执行查询：

/**
 * 根据给定的日期区间数组，迭代执行SQL查询。
 *
 * @param PDO $database PDO数据库连接对象。
 * @param array $intervals 包含日期区间的数组，每个元素应包含 'date_from' 和 'date_till' 键。
 * @return array 返回一个包含所有查询结果的数组。
 */
function queryDataByIntervals(PDO $database, array $intervals): array
{
    // 定义SQL查询模板，使用命名占位符进行参数绑定
    $sql = "SELECT id, order_date, total_amount FROM orders WHERE order_date BETWEEN :date_from AND :date_till";

    // 准备SQL语句，只需准备一次
    $stmt = $database->prepare($sql);

    $allResults = [];

    foreach ($intervals as $interval) {
        // 绑定参数并执行查询
        $result = $stmt->execute([
            ':date_from' => $interval['date_from'],
            ':date_till' => $interval['date_till'],
        ]);

        if ($result === false) {
            // 错误处理：记录日志或抛出异常
            error_log("SQL execution failed for interval: " . json_encode($interval));
            // 根据实际需求决定是否继续或中断
            continue; 
        }

        // 获取所有匹配的行
        $rows = $stmt->fetchAll(PDO::FETCH_ASSOC);

        // 可选：在此处对获取到的行集进行进一步处理，例如更新、汇总等
        // foreach ($rows as &$row) {
        //     $row['processed_at'] = date('Y-m-d H:i:s');
        // }

        $allResults[] = $rows;
    }

    return $allResults;
}

// 调用函数执行查询
// $queryResults = queryDataByIntervals($pdo, $dateIntervals);

// 打印结果（示例）
// foreach ($queryResults as $intervalResult) {
//     echo "--- New Interval Results ---" . PHP_EOL;
//     foreach ($intervalResult as $row) {
//         print_r($row);
//     }
// }
?>

注意事项：

• PDO错误处理：在实际应用中，务必配置PDO以抛出异常（PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION），或者在 execute() 返回 false 时进行详细的错误检查（$stmt->errorInfo()）。
• 数据量与性能：如果 $dateIntervals 数组非常大，或者单个区间内的查询结果集非常大，需要考虑性能优化。例如，可以考虑使用单个更复杂的SQL查询（如利用 UNION ALL 或 IN 子句配合多个日期范围），或者分批处理数据以减少内存占用。
• 灵活性：如果不同查询需要不同的SQL语句，可以将SQL模板也作为参数传递给 queryDataByIntervals 函数，或者创建更通用的查询构建器。

进阶优化：单次复杂查询

在某些情况下，如果所有查询的结构相似，并且只需要获取数据，可以考虑构建一个更复杂的SQL查询，一次性获取所有日期区间的数据。这通常涉及将多个 WHERE 条件通过 OR 组合，或者使用 UNION ALL。

/**
 * 通过一个复杂的SQL查询一次性获取所有日期区间的数据。
 * 这种方法适用于SQL逻辑允许且数据量适中的情况。
 *
 * @param PDO $database PDO数据库连接对象。
 * @param array $intervals 包含日期区间的数组。
 * @return array 返回所有查询结果的数组。
 */
function queryAllDataWithComplexSql(PDO $database, array $intervals): array
{
    $whereClauses = [];
    $params = [];

    foreach ($intervals as $index => $interval) {
        $dateFromKey = ":date_from_" . $index;
        $dateTillKey = ":date_till_" . $index;

        $whereClauses[] = "(order_date BETWEEN $dateFromKey AND $dateTillKey)";
        $params[$dateFromKey] = $interval['date_from'];
        $params[$dateTillKey] = $interval['date_till'];
    }

    if (empty($whereClauses)) {
        return []; // 没有区间，直接返回空
    }

    $sql = "SELECT id, order_date, total_amount FROM orders WHERE " . implode(" OR ", $whereClauses);

    $stmt = $database->prepare($sql);
    $stmt->execute($params);

    return $stmt->fetchAll(PDO::FETCH_ASSOC);
}

// 调用函数
// $allCombinedResults = queryAllDataWithComplexSql($pdo, $dateIntervals);
// print_r($allCombinedResults);

这种方法减少了与数据库的往返次数，对于大量小范围查询可能更高效。但需要注意，OR 条件过多可能会影响某些数据库的查询优化器性能。

总结

在PHP中处理动态SQL查询与日期范围迭代时，最佳实践是：

• 避免使用 global 变量，而是通过函数参数传递依赖（如PDO连接）。
• 结构化输入数据，将日期区间或其他动态参数组织成数组。
• 利用PDO预处理语句，确保SQL查询的安全性（防止SQL注入）和效率。
• 根据场景选择迭代方式：对于每个区间执行独立查询，或构建复杂查询一次性获取所有数据。
• 实现健壮的错误处理，确保应用程序在数据库操作失败时能够优雅地响应。

遵循这些原则将有助于您编写出更清晰、更安全、更易于维护的PHP数据库交互代码。