PHP循环引入文件后$db_link仅部分函数可用问题排查

核心是PHP的require_once特性+变量作用域规则共同导致的问题，循环引入只是次要诱因：

1. require_once只会加载目标文件一次，后续调用不会重复执行文件内的代码
2. 在函数内部require的文件，文件中定义的变量仅属于当前函数的局部作用域，不会自动成为全局变量，也不会导入到其他函数的作用域中

具体执行流程如下：

• 首次调用saveScoreToDB函数时，执行到require_once "db_connection.php"，此时是第一次加载该文件，文件内的代码正常执行，生成的$db_link变量成为saveScoreToDB的局部变量，因此该函数内可以正常使用。同时db_connection.php被标记为已加载。
• 后续调用completeTest函数时，执行require_once "db_connection.php"，检测到文件已加载就不会再执行文件内的代码，completeTest的作用域中没有定义$db_link变量，因此抛出未定义错误。

额外的循环引入问题：db_connection.php反向引入helpers.php虽然因为require_once不会触发死循环，但属于不合理的依赖结构，会进一步加剧加载逻辑的混乱。

第一步：消除循环依赖 #

将helpers.php中的通用工具函数（比如示例中的lineBreak()）拆分到独立的utils.php文件，db_connection.php和helpers.php都改为引入utils.php，断开循环引入。

第二步：优化数据库连接获取逻辑 #

不要在函数内部通过require引入连接，改用单例函数统一获取连接实例，彻底规避作用域问题：

1. 修改db_connection.php，新增连接获取函数：

<?php
require_once "db_credentials.php";
require_once "utils.php";

function get_db_link() {
    // 静态变量保存连接实例，避免重复创建
    static $db_link = null;
    if ($db_link === null) {
        global $host, $dbname, $user, $pass;
        $dsn = "mysql:host=$host;dbname=$dbname;port=3307;charset=utf8;";
        $options = [
            PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES   => false
        ];
        try {
            $db_link = new PDO($dsn, $user, $pass, $options);
        } catch (PDOException $e) {
            echo "Error connecting to the database.";
            echo lineBreak();
            echo $e->getMessage();
            echo lineBreak();
            echo lineBreak();
            exit;
        }
    }
    return $db_link;
}

2. 修改helpers.php中的两个函数，移除内部的require_once "db_connection.php"，改为调用get_db_link()获取连接：

// saveScoreToDB函数内的修改示例
try {
    $query_etapa = "SELECT id FROM etapas WHERE numero = $etapa";
    // 替换原来的require_once
    $db_link = get_db_link();
    $etapa_id = $db_link->query($query_etapa)->fetchColumn();
    // 后续逻辑不变
}

// completeTest函数内的修改示例
try {
    $queryEmailUsuario = "SELECT email FROM usuarios WHERE id = $usuarioId";
    $queryNomeUsuario = "SELECT nome FROM usuarios WHERE id = $usuarioId";
    // 替换原来的require_once
    $db_link = get_db_link();
    $emailUsuario = $db_link->query($queryEmailUsuario)->fetchColumn();
    $nomeUsuario = $db_link->query($queryNomeUsuario)->fetchColumn();
    // 后续逻辑不变
}

额外优化建议 #

当前SQL写法直接拼接变量存在SQL注入风险，建议改为PDO预处理语句传参，避免安全问题。

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