Adminer无缝集成与自动登录配置指南

<?php
// adminer.include.php

// 数据库连接常量，根据实际情况修改
define('DB_SERVER', 'localhost');
define('DB_USERNAME', 'your_username');
define('DB_PSWD', 'your_password');
define('DB_NAME', 'your_database');

/**
 * Adminer定制对象函数
 * 用于扩展 Adminer 的默认行为
 */
function adminer_object()
{
    // 引入 Adminer 插件基础，如果使用插件则需要
    include_once __DIR__ . '/plugins/plugin.php';

    // 自动加载所有插件 (可选)
    foreach (glob(__DIR__ . '/plugins/*.php') as $filename) {
        include_once $filename;
    }

    // 定义 Adminer 定制类
    class AdminerCustomization extends AdminerPlugin
    {
        /**
         * 提供一个用于永久登录的密钥
         * Adminer会使用此密钥来加密和存储永久登录信息到Cookie中。
         * 必须是一个随机且稳定的字符串，每次应用启动时都相同。
         *
         * @return string 永久登录密钥
         */
        public function permanentLogin()
        {
            // 替换为你的唯一随机字符串，不要与他人共享
            return 'a_very_secret_and_random_string_for_your_adminer_instance';
        }

        // 你也可以在此处覆盖其他Adminer方法，例如：
        // public function name() { return '我的数据库面板'; }
        // public function database() { return DB_NAME; }
        // public function credentials() { return [DB_SERVER, DB_USERNAME, DB_PSWD]; }
        // public function login($login, $password) { /* ... 验证逻辑 ... */ return true; }
    }

    // 实例化定制类并返回
    return new AdminerCustomization(/* 传入插件数组，如果未使用插件则留空 */);
}

// ... 后续代码

<?php
// adminer.include.php (接上文)

// ... adminer_object() 函数定义 ...

/**
 * 检查是否需要触发自动登录
 *
 * 只有在以下两种情况之一时才模拟登录：
 * 1. 首次访问页面（URL中没有查询字符串）。
 * 2. 浏览器中不存在Adminer的永久登录Cookie。
 * 这样可以避免在用户已登录后，每次页面刷新都重新尝试登录。
 */
if (empty($_SERVER['QUERY_STRING']) || empty($_COOKIE['adminer_permanent'])) {
    $_POST['auth'] = [
        'driver'    => 'server',        // 数据库驱动类型，通常是 'server'
        'server'    => DB_SERVER,       // 数据库服务器地址，使用常量
        'username'  => DB_USERNAME,     // 数据库用户名，使用常量
        'password'  => DB_PSWD,         // 数据库密码，使用常量
        'db'        => DB_NAME,         // 默认连接的数据库，使用常量
        'permanent' => 1,               // 启用永久登录，值为 1
    ];
}

// 最后，引入 Adminer 核心文件
include_once __DIR__ . '/adminer.php';

<?php
// adminer.include.php - 用于集成 Adminer 并实现自动登录

// 数据库连接常量，请根据你的实际环境修改
define('DB_SERVER', 'localhost');
define('DB_USERNAME', 'your_database_user');
define('DB_PSWD', 'your_database_password');
define('DB_NAME', 'your_database_name');

/**
 * Adminer定制对象函数
 * 用于扩展 Adminer 的默认行为，特别是实现永久登录功能。
 */
function adminer_object()
{
    // 引入 Adminer 插件基础文件，如果使用了任何插件，这是必需的。
    include_once __DIR__ . '/plugins/plugin.php';

    // 自动加载所有插件 (可选)
    // 如果你有自定义插件，将它们放在 'plugins' 目录下，这里会自动加载。
    foreach (glob(__DIR__ . '/plugins/*.php') as $filename) {
        include_once $filename;
    }

    // 定义一个 Adminer 定制类，继承自 AdminerPlugin。
    // 在这里我们可以覆盖 Adminer 的默认行为。
    class AdminerCustomization extends AdminerPlugin
    {
        /**
         * 实现 permanentLogin 方法，为 Adminer 提供一个用于永久登录的密钥。
         * 这个密钥用于加密和解密存储在用户浏览器 Cookie 中的登录凭据。
         * 它必须是一个随机、复杂且在你的应用中保持不变的字符串。
         *
         * @return string 永久登录密钥。
         */
        public function permanentLogin()
        {
            // !!! 重要：请替换为你的应用程序独有的、安全的、随机的字符串 !!!
            // 泄露此密钥可能导致安全风险。
            return 'my_super_secret_key_for_adminer_autologin_12345XYZ';
        }

        // 以下方法可以根据需要选择性覆盖，例如：
        // public function name() { return '我的自定义Adminer面板'; }
        // public function database() { return DB_NAME; } // 默认连接的数据库
        // public function credentials() { return [DB_SERVER, DB_USERNAME, DB_PSWD]; } // 默认凭据
    }

    // 实例化定制类并返回。
    // 如果你使用了插件，将插件数组作为参数传递给构造函数。
    $plugins = [
        // new AdminerTranslation, // 示例：如果需要翻译插件
        // new AdminerForeignSystem, // 示例：如果需要外键系统插件
    ];
    return new AdminerCustomization($plugins);
}

/**
 * 触发 Adminer 自动登录。
 *
 * 逻辑：
 * 1. 如果当前请求的 URL 没有查询字符串 (即首次访问 Adminer 页面)。
 * 2. 或者，如果 Adminer 的永久登录 Cookie 不存在 (即用户尚未通过永久登录保持会话)。
 * 在这两种情况下，我们模拟一个登录表单提交，以实现自动登录。
 */
if (empty($_SERVER['QUERY_STRING']) || empty($_COOKIE['adminer_permanent'])) {
    $_POST['auth'] = [
        'driver'    => 'server',        // 数据库驱动类型 (例如 'server', 'sqlite', 'oracle')
        'server'    => DB_SERVER,       // 数据库服务器地址
        'username'  => DB_USERNAME,     // 数据库用户名
        'password'  => DB_PSWD,         // 数据库密码
        'db'        => DB_NAME,         // 默认连接的数据库
        'permanent' => 1,               // 设置为 1 启用永久登录功能，Adminer 会设置一个 Cookie。
    ];
}

// 引入 Adminer 核心文件。
// 确保 'adminer.php' 文件与此文件在同一目录下，或提供正确的相对/绝对路径。
include_once __DIR__ . '/adminer.php';

?>

<!DOCTYPE html>
<html>
<head>
    <title>Adminer集成</title>
    <style>
        html, body { margin: 0; padding: 0; height: 100%; overflow: hidden; }
        iframe { border: none; }
    </style>
</head>
<body>
    <iframe id="frame_adminer" src="adminer.include.php" style="width:100%;height:100%;"></iframe>
</body>
</html>