Qtun 專案實戰：嵌入 Lua 腳本引擎實現靈活配置與插件擴展

編輯：關於C語言

專案背景與動機

隨著 Qtun 專案功能迭代，可配置參數日益增多。C 語言處理字串與複雜配置解析能力較弱，團隊決定引入輕量級 Lua 腳本語言作為配置載體，同時為未來第三方插件系統奠基。

核心代碼修改詳解

1. Lua 環境初始化：`script_global_init`

在 init_lua 階段調用，註冊標準庫並綁定 Qtun 內部物件：

int script_global_init(lua_State* lua) {
    load_lib(lua, "_G", luaopen_base);      // 基礎庫
    load_lib(lua, LUA_TABLIBNAME, luaopen_table); // table 庫
    load_lib(lua, LUA_STRLIBNAME, luaopen_string); // string 庫
    load_lib(lua, LUA_IOLIBNAME, luaopen_io);      // io 庫

    // 註冊 C 函數供 Lua 調用
    lua_pushcfunction(lua, _syslog);
    lua_setglobal(lua, "_syslog");

    // 將 C 結構體映射到 Lua 表（透過 metatable）
    init_qtun_state(lua);  // qtun.state
    init_qtun_conf(lua);   // qtun.conf
    init_qtun_log(lua);    // qtun.log (僅定義日誌等級常數)
    return 1;
}

關鍵點：qtun.state 和 qtun.conf 透過 metatable 實現 C 物件到 Lua 表的雙向映射；qtun.log 僅暴露常數。

2. 配置載入入口：`script_load_config`

調用 Lua 腳本 scripts/load_config.lua 解析配置文件：

int script_load_config(lua_State* lua, library_conf_t* conf, const char* file_path) {
    char path[MAX_PATH];
    lua_pushlightuserdata(lua, conf);
    lua_setglobal(lua, "__conf__");  // 傳遞 C 結構體指標給 Lua

    strcpy(path, qtun->this_path);
    strcat(path, "scripts/load_config.lua");
    if (luaL_dofile(lua, path) != 0) {
        fprintf(stderr, "%s\n", lua_tostring(qtun->lua, -1));
        lua_close(qtun->lua);
        exit(1);
    }
    return 1;
}