Lua 5.1 標準 require/package.loadlib 只能加載遵循 Lua C API 規範(導出 luaopen_xxx)的擴展庫。若需調用通用 DLL(如系統庫 msvcrt.dll、第三方 SDK),必須使用 alien 库通過 libffi 進行動態調用。本文詳細講解加載流程、類型聲明、參數傳遞、引用參數處理。
依賴準備
- Lua 5.1 +
luaalien.lua(alien 核心模塊,純 Lua 實現,依賴 libffi)。
- 目標 DLL:示例用
msvcrt.dll (Microsoft C Runtime)。
三步加載流程
-- 1. 加載 alien
require("alien")
-- 2. 加載 DLL
local libc = alien.load("msvcrt.dll")
-- 3. 聲明函數簽名:返回類型 + 參數類型
libc.puts:types("void", "string") -- void puts(const char*)
類型映射表
| Lua/alien 類型 | C 類型 | 說明 |
| "void" | void | 無返回值 |
| "int" | int | |
| "long" | long | |
| "float"/"double" | float/double | |
| "string" | const char* | Lua 字符串自動轉 C 字符串 |
| "pointer" | void* | userdata 承載指針 |
| "ref int" | int* | 引用參數,alien 在棧分配空間 |
| "ref double" | double* | 引用參數 |
調用示例
-- 簡單調用
libc.puts("test") -- 輸出: test
-- 掃描輸入 (引用參數)
local scanf = libc.scanf
scanf:types("int", "string", "ref int", "ref double")
local _, x, y = scanf("%i %lf", 1, 1) -- 後兩個佔位參數
-- 用戶輸入: 23 24.5
print(x, y) -- 23 24.5
引用參數機制詳解
- 聲明
"ref int" 時,alien 在內部棧分配 sizeof(int) 空間,將指針傳給 C 函數。
- C 函數寫入該地址。
- 調用返回時,alien 從該地址讀取值,作為返回值之一(多返回值)。
- 返回值數量 = 1 (函數返回值) + 引用參數個數。
進階:調用 Windows API
local user32 = alien.load("user32.dll")
user32.MessageBoxA:types("int", "pointer", "string", "string", "int")
user32.MessageBoxA(nil, "Hello from Lua!", "Title", 0) -- 彈出消息框
注意事項
- 調用約定:Windows API 多為
__stdcall,alien 默認 cdecl。需確認 alien 版本支持 stdcall(部分分支支持 :stdcall() 修飾)。
- 64 位兼容:指針大小、調用約定不同,需 64 位 alien + 64 位 DLL。
- 內存管理:alien 不自動管理 C 端分配的內存,需約定釋放責任。
- 錯誤處理:C 函數崩潰會直接讓 Lua VM 崩潰,建議關鍵調用隔離在獨立進程。
alien 讓 Lua 獲得「無縫調用任何 C 庫」的超能力,是系統編程、逆向分析、快速原型驗證的利器。
copyright ©
萬盛學電腦網 all rights reserved