api文档 luci_开发OpenWrt路由器上LuCI的模块

【题外话】

学校里最近改造了校园网，要求必须用iNode验证，万幸的是路由器能刷OpenWrt，并且OpenWrt上有好多iNode认证的开源项目，比如njit8021xclient(以下简称njit-client)就非常好用。虽然程序写的好用，但是配置起来还是稍微麻烦一些的，大家通常的方法是在/etc/init.d下写启动脚本，把用户名、密码什么的都直接填进去，但毕竟配置起来不方便，同时日后修改起来也不便。好在用Lua为LuCI写配置模块很简单，索性就自己做了一个，现在把开发的流程写一下，方便初学的同学去做。为njit-client做好的Web配置界面也已经开源，地址：https://github.com/mayswind/luci-app-njitclient，或者直接下载编译好(不限平台)的文件：http://pan.baidu.com/s/1CbPal

【文章索引】

【一、LuCI配置界面开发的框架】

LuCI是OpenWrt上的Web管理界面，LuCI采用了MVC三层架构，同时其使用Lua脚本开发，所以开发LuCI的配置界面不需要编辑任何的Html代码，除非想自己单独去创建网页(View层)，否则我们基本上只需要修改Model层就可以了。官方也有一个如何去创建模块的说明文档，虽然写的比较晦涩：http://luci.subsignal.org/trac/wiki/Documentation/ModulesHowTo

要为LuCI增加一个新模块，首先需要创建两个文件，一个位于Controller(/usr/lib/lua/luci/controller/)下，定义模块的入口；另一个位于Model(/usr/lib/lua/luci/model/cbi/)下，为配置模块实际的代码。

首先我们定义模块的入口，在/usr/lib/lua/luci/controller/下创建一个lua文件，类似如下：

module("luci.controller.控制器名", package.seeall)functionindex()

entry(路径, 调用目标, _("显示名称"), 显示顺序)end

第一行说明了程序和模块的名称，比如在controller/目录创建一个mymodule.lua，那么就可以写成“luci.controller.mymodule”，如果你的程序比较多，可能分为好几个模块，那么可以在controller下再常见一个子目录，比如controller/myapp/，那么就可以写成“luci.controller.myapp.mymodule”。

接下来的entry表示添加一个新的模块入口，官方给出了entry的定义，其中后两项都是可以为空的：

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

第一项是访问的路径，不过路径是按字符串数组给定的，比如路径按如下方式写“{"click", "here", "now"}”，那么就可以在浏览器里访问“http://192.168.1.1/cgi-bin/luci/click/here/now”来访问这个脚本。而通常我们希望为管理员菜单添加脚本，那么我们需要按如下方式编写“{"admin", "一级菜单名", "菜单项名"}”，系统会自动在对应的菜单中生成菜单项。比如想在“网络”