如何在不干扰现有逻辑的情况下为数据库查询函数添加手机号查询

核心思路 #

通过独立开关+解耦逻辑的方式，完全不改动原有地址相关代码，新增手机号查询功能：

步骤1：新增手机号查询的独立控制方法 #

在当前类中添加一个单独的判断方法，用来控制是否启用手机号查询，和原有的shouldIncludeAddress()逻辑完全隔离：

/**
 * 判断是否需要启用手机号查询
 * @return bool
 */
private function shouldIncludePhone() {
    // 根据实际业务场景调整判断逻辑，比如从请求参数、配置读取
    return isset($_GET['phone']) && trim($_GET['phone']) !== '';
}

步骤2：单独添加手机号查询过滤条件 #

在原有地址逻辑的代码块之后，新增独立的查询处理逻辑，避免混入原有逻辑：

// 原有地址逻辑保持不动
if ($this->shouldIncludeAddress()) {
    $donorQuery->attachMeta('give_donormeta',
        'donors.ID',
        'donor_id',
        ['give_phone', 'give_phone'],// 原有代码保留
        ['_give_donor_address_billing_line1_0', 'address_line1'],
        ['_give_donor_address_billing_line2_0', 'address_line2'],
        ['_give_donor_address_billing_city_0',  'address_city'],
        ['_give_donor_address_billing_state_0', 'address_state'],
        ['_give_donor_address_billing_zip_0',   'address_zip'],
        ['_give_donor_address_billing_country_0', 'address_country'],
    );
}

// 新增手机号查询逻辑，完全独立
if ($this->shouldIncludePhone()) {
    $phone = sanitize_text_field(trim($_GET['phone']));
    // 关联元数据表并添加过滤条件，根据需求选INNER/LEFT JOIN
    $donorQuery->join('give_donormeta', 'donors.ID', '=', 'give_donormeta.donor_id', 'INNER')
               ->where('give_donormeta.meta_key', '=', 'give_phone')
               ->where('give_donormeta.meta_value', '=', $phone);
}

步骤3：可选：独立拉取手机号字段（如果需要返回结果） #

如果需要在查询结果中返回手机号，同样单独处理，不和地址字段拉取混在一起：

if ($this->shouldIncludePhone()) {
    $donorQuery->attachMeta('give_donormeta',
        'donors.ID',
        'donor_id',
        ['give_phone', 'donor_phone'] // 用别名避免字段冲突
    );
}

方案优势 #

• 完全隔离原有逻辑：原有的地址判断、字段拉取代码一行都不用改，不会引入回归风险
• 逻辑解耦：手机号查询的开关、过滤、字段拉取都是独立模块，后续维护或修改只需要动这部分代码
• 安全合规：用sanitize_text_field()处理输入参数，避免SQL注入风险

内容的提问来源于stack exchange，提问作者venkatesh A.V