【OpenWRT之旅】如何自定義一個配置文件的設置界面

做者：gnuhpc
出處：http://www.cnblogs.com/gnuhpc/

1. 引言

OpenWRT中採用LuCI做爲它的Web interface界面框架，採用Lua語言。在本文中將以一個簡單的示例詳細描述如何自定義開發一個界面，對一個配置文件進行操做。

2.Model與Controler

MVC的設計理念是進行LuCI開發的一個關鍵，什麼是MVC請參看以下Blog：

http://www.cnblogs.com/gnuhpc/archive/2012/12/21/2827597.html

在LuCI中Controller的文件定義在固件中的/usr/lib/lua/luci/controller目錄中，模版目錄在/usr/lib/lua/luci/view目錄下，而model則是在/usr/lib/lua/luci/model中。而model中有一個特殊的模塊叫作CBI，被稱爲LuCI中最酷的功能，該模塊的功能是方便的對一個配置文件進行修改。

3.示例

本文中的頁面創建在LuCI界面的network下，不單首創建頁面，所以無需寫view，只用些controller和model就能夠了。

1）首先建立一個controller

ccontroller/mycbi.lua

module("LUCI.controller.mycbi", package.seeall)

function index()
	entry({"admin", "network", "mycbi_change"}, cbi("mycbi-model/mycbimodule"), "Change My Conf", 30).dependent=false
end

解釋一下關鍵代碼：

在index()函數中，使用entry函數來完成每一個模塊函數的註冊，官方說明文檔以下：

entry(path, target, title=nil, order=nil)

• path is a table that describes the position in the dispatching tree: For example a path of {"foo", "bar", "baz"} would insert your node in foo.bar.baz.
• target describes the action that will be taken when a user requests the node. There are several predefined ones of which the 3 most important (call, template, cbi) are described later on on this page
• title defines the title that will be visible to the user in the menu (optional)
• order is a number with which nodes on the same level will be sorted in the menu (optional)

其中target主要分爲三類：call，template和cbi。call用來調用函數，template用來調用已有的htm模版，而CBI模塊則是使用很是頻繁也很是方便的模塊，包含的一系列lua文件構成界面元素的組合，全部cbi模塊中的控件都須要寫在luci.cbi.Map中，在cbi模塊中定義各類控件，Luci系統會自動執行大部分處理工做。在cbi.lua文件中封裝了全部的控件元素，例如複選框，下拉列表等。

 

2）建立model

#mkdir /usr/lib/lua/luci/model/cbi/mycbi-model

#vim /usr/lib/lua/luci/model/cbi/mycbi-model/mycbimodule.lua

m = Map("mycbi", "mycbi conf change interface")
s = m:section(TypedSection, "MySection")
s.addremove = true
s:option(Value, "username", "Name:")
key=s:option(Value, "password", "Password")
key.password=true;
return m

解釋一下關鍵代碼：

3)建立配置文件

#vim /etc/config/mycbi

config  'MySection'  'mycbi'

option 'username' 'youruser'
option 'password' 'yourpass'

4. 測試

進入OpenWRT界面，登錄後就能夠點擊「網絡」，若是是英文就點擊network，能夠看到咱們添加的子頁面入口：

點擊後進入頁面以下：

輸入用戶名密碼：root/test，點擊保存，後臺查看配置文件已經被更改：

 

5. 問題記錄

1）首先，配置文件不能有任何後綴，不然頁面加載後是空頁面

2）若是出現500 錯誤，說明lua文件寫的有問題，要麼是路徑錯誤，要麼是語法錯誤，暫時沒找到寫日誌的方法，能夠用wireshark抓包看錯誤，以下：

6.參考文獻

http://www.cnblogs.com/dwayne/archive/2012/04/18/2455145.html

http://www.cnblogs.com/dwayne/archive/2012/04/21/2460830.html

 

做者：gnuhpc
出處：http://www.cnblogs.com/gnuhpc/