PHP类函数调用：无需变量实例化Db类兼容原有db_query调用

你的需求非常合理——既要用类封装数据库逻辑提升可维护性，又不想动现有大量的db_query($query)调用。这里有个完美的折中方案，核心思路是保留全局函数作为类方法的“代理”，既复用类的优势，又完全兼容旧代码。

调整后的dbconnect.php代码 #

class Db {
    protected static $connection;
    
    public function __construct() {
        // 初始化DEBUG全局变量（如果未设置）
        if (! isset($GLOBALS['DEBUG'])) {
            $GLOBALS['DEBUG'] = 0;
        }
    }
    
    public function connect() {
        // 复用已有的连接，避免重复建立连接
        if(!isset(self::$connection)) {
            // 注意：mysqli构造函数不支持PDO风格的DSN字符串
            // 如果你的$GLOBALS['DSN']是数组（比如[主机, 用户名, 密码, 数据库名]），可以用展开运算符：
            // self::$connection = new mysqli(...$GLOBALS['DSN']);
            // 如果是PDO风格DSN，需要先解析成mysqli需要的参数，示例见下文
            self::$connection = new mysqli($GLOBALS['DSN']);
            
            // 检查连接错误
            if (self::$connection->connect_error) {
                trigger_error('数据库连接失败: ' . self::$connection->connect_error, E_USER_ERROR);
            }
        }
        
        if(self::$connection === false) {
            return false;
        }
        
        // 连接成功后清除敏感信息
        unset($GLOBALS['DSN']);
        return self::$connection;
    }
    
    public function db_query($query) {
        $connection = $this->connect();
        $result = $connection->query($query);
        
        // DEBUG模式下记录SQL错误
        if ($GLOBALS['DEBUG'] && $connection->error) {
            error_log(sprintf('SQL错误: %s | 查询语句: %s', $connection->error, $query));
        }
        
        return $result;
    }
}

// 保留全局的db_query函数，作为类方法的代理
function db_query($query) {
    // 用静态变量保存Db实例，实现单例，确保整个请求周期只实例化一次
    static $dbInstance = null;
    
    if ($dbInstance === null) {
        $dbInstance = new Db();
    }
    
    return $dbInstance->db_query($query);
}

现有代码无需任何修改 #

其他php文件还是像原来一样使用，完全不用调整：

include_once 'dbconnect.php';

$query = "SELECT * FROM table;";
$result = db_query($query);

// 正常处理查询结果即可
if ($result && $result->num_rows > 0) {
    while($row = $result->fetch_assoc()) {
        // 处理数据
    }
}

方案优势 #

• 完全兼容旧代码：99.9%的现有db_query($query)调用无需改动，直接正常工作
• 保留类的优势：数据库逻辑封装在Db类中，后续可以轻松扩展预处理语句、事务、错误处理等功能
• 连接复用：通过类的静态$connection属性和全局函数的单例实例，避免重复建立数据库连接
• 安全性：连接建立后清除$GLOBALS['DSN']的逻辑得以保留，减少敏感信息泄露风险

注意事项 #

1. mysqli的DSN兼容问题：
   mysqli不支持PDO风格的DSN字符串（比如mysql:host=localhost;dbname=test），如果你的$GLOBALS['DSN']是这种格式，需要先解析成mysqli需要的参数：

   // 示例：解析PDO风格DSN
   preg_match('/host=(.*?);dbname=(.*?)(?:;charset=(.*?))?(?:;|$)/', $GLOBALS['DSN'], $matches);
   $host = $matches[1];
   $dbname = $matches[2];
   $charset = $matches[3] ?? 'utf8mb4';
   
   // 假设用户名密码存在其他全局变量中
   self::$connection = new mysqli($host, $GLOBALS['DB_USER'], $GLOBALS['DB_PASS'], $dbname);
   self::$connection->set_charset($charset);
   

2. 逐步重构过渡：后续新开发的代码可以直接使用$db = new Db(); $db->db_query($query);的方式，慢慢向类调用过渡，不用一次性全面重构系统

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