PHP函数与类相互依赖加载顺序问题求助

针对你遇到的函数与类加载顺序冲突导致的Fatal error: Uncaught Error: Call to a member function query() on null错误，以下是几个可落地的解决方案：

1. 延迟函数内的依赖调用（最小改动） #

不要在函数定义阶段依赖全局实例，而是在函数执行时确保依赖已初始化，或者通过依赖注入传递实例，避免加载顺序问题。

方式A：函数内懒加载实例 #

function get_user($id) {
    global $db;
    // 检查实例是否存在，不存在则初始化
    if (!$db instanceof Database) {
        $db = new Database();
    }
    return $db->query("SELECT * FROM users WHERE id = ?", [$id]);
}

方式B：依赖注入（更可控） #

让调用者主动传递数据库实例，彻底摆脱全局变量依赖：

function get_user($id, Database $db) {
    return $db->query("SELECT * FROM users WHERE id = ?", [$id]);
}

// 调用时（确保此时Database已初始化）
$db = new Database();
$user = get_user(1, $db);

2. 重构函数为类方法（长期维护首选） #

将依赖数据库的全局函数封装为类的方法，利用PHP自动加载机制处理类依赖，同时通过构造函数注入数据库实例，从根源避免加载顺序问题：

// UserService.php（自动加载覆盖的路径下）
class UserService {
    private Database $db;

    // 构造时注入数据库实例
    public function __construct(Database $db) {
        $this->db = $db;
    }

    public function getUserById(int $id) {
        return $this->db->query("SELECT * FROM users WHERE id = ?", [$id]);
    }
}

// 使用示例
$db = new Database();
$userService = new UserService($db);
$user = $userService->getUserById(1);

3. 优化函数加载逻辑（自动处理依赖顺序） #

给依赖数据库的函数文件添加标记注释（比如@depends Database），扫描时先解析依赖关系，按依赖优先级排序后再加载，替代手动调整：

// 扫描函数文件并解析依赖
$functionFiles = glob('path/to/functions/*.func');
$fileDependencies = [];
$pendingFiles = array_flip($functionFiles);

// 第一步：提取每个文件的依赖
foreach ($functionFiles as $file) {
    $content = file_get_contents($file);
    if (preg_match('/@depends\s+Database/', $content)) {
        $fileDependencies[$file] = 'Database';
    }
}

// 第二步：按依赖顺序加载
while (!empty($pendingFiles)) {
    $loadedCount = 0;
    foreach ($pendingFiles as $file => $_) {
        // 无依赖 或 依赖的类已加载
        if (!isset($fileDependencies[$file]) || class_exists($fileDependencies[$file])) {
            require_once $file;
            unset($pendingFiles[$file]);
            $loadedCount++;
        }
    }
    // 检测循环依赖
    if ($loadedCount === 0) {
        throw new Exception("循环依赖检测：无法加载文件 " . implode(', ', array_keys($pendingFiles)));
    }
}

4. 统一入口初始化（全局流程管控） #

调整项目入口的初始化顺序，确保所有依赖的基础组件先加载完成：

// 入口文件 index.php
// 1. 注册类自动加载器
spl_autoload_register(function ($className) {
    require_once __DIR__ . '/classes/' . $className . '.php';
});

// 2. 加载数据库类依赖的核心函数（如果有的话）
require_once __DIR__ . '/core_functions.func';

// 3. 初始化数据库实例
$GLOBALS['db'] = new Database();

// 4. 加载所有业务函数
foreach (glob(__DIR__ . '/functions/*.func') as $file) {
    require_once $file;
}

// 5. 执行业务逻辑
$user = get_user(1);

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