LUCI 这个在百度上搜索除了一篇我的百度文库luci的介绍文章之外，前三页都是些不知所云的名词（足见百度在专业领域的搜索之烂），我却在大学毕业的大半年的大部分时间里与它纠结，由于开始的发懵到后来逐渐感觉到这家伙还很好玩的，现在就把我对luci的浅显认识介绍给大家。
官网：
有关luci的各个方面，你几乎都可以从这里获得，当然，只是浅显的获得，luci的文档写的还算比较全，但是写的稍显简略，开始看的时候会有一点不知所措。
UCI 熟悉openwrt的人都会有所了解，就是Uni?ed Con?guration Interface的简称，而luci这个openwrt上的默认web系统，是一个独立的由严谨的德国人开发的web框架，是Lua Con?guration Interface的简称，如果在您的应用里，luci是对openwrt的服务，我们就有必要做一下uci的简介，我这里就不说了，见链接：
有的时候，我们开发的luci是在自己的Linux PC上开发，在普通的linux上，一般是没有uci命令的，为了开发方便，可以手动编译一下，方法见链接：
OK ,之前罗里罗嗦的说了很多，现在就进入正题，进入正题的前提是你已经make install正确的安装了lua ，luci，以及编译好链接了相关的so（如果你需要，比如uci.so nixio.so），以及make install正确web server，（我用的web server是thttpd，也编译过mongoose，lighttpd，在这三个之中，lighttpd是功能最完善的，mongoose是最小巧的）。
进入正题：
一：luci的启动
在web server中的cgi-bin目录下，运行luci文件（权限一般是755），luci的代码如下：
-
#!/usr
/bin/lua --cgi的执行命令的路径require"luci.cacheloader" --导入cacheloader包
require"luci.sgi.cgi" --导入sgi.cgi
包 luci.dispatcher.indexcache = "/tmp/luci-indexcache" --cache缓存路径地址
-
luci.sgi.cgi.run() --执行run方法，此方法位于*/luci/sgi/cgi.lua中
run方法的主要任务就是在安全的环境中打开开始页面（登录页面），在run中，最主要的功能还是在dispatch.lua中完成。
运行luci之后，就会出现登录界面：
-
-bash-4.0# pwd
-
/var/www/cgi-bin
-
-bash-4.0# ./luci
-
Status: 200 OK
-
Content-Type: text/html;
-
charset=utf-8
-
Cache-Control: no-cache
-
Expires: 0
-
-
"">
-
<html class=" ext-strict">
-
/*some html code*/
-
html>
如果你成功的运行了luci 就说明你的luci框架成功的跑了起来。
二：LUCI的MVC
1：用户管理：
在luci的官方网站说明了luci是一个MVC架构的框架，这个MVC做的可扩展性很好，可以完全的统一的写自己的html网页，而且他对shell的支持相当的到位，（因为luci是lua写的，lua是C的儿子嘛， 与shell是兄弟）。在登录界面用户名的选择很重要， luci是一个单用户框架，公用的模块放置在*/luci/controller/下面，各个用户的模块放置在*/luci/controller/下面对应的文件夹里面，比如 admin登录，最终的页面只显示/luci/controller/admin下面的菜单。这样既有效的管理了不同管理员的权限。
2：controller文件夹下的lua文件说明：（以mini用户为例）
在mini目录下面，会有一个index.lua文件，简略的代码如下：
-
module("luci.controller.mini.index", package.seeall)
-
17
-
18 function index()
-
19 luci.i18n.loadc("admin-core")
-
20 local i18n = luci.i18n.translate
-
21
-
22 local root = node()
-
23 if not root.lock then
-
24 root.target = alias("mini")
-
25 root.index = true
-
26 end
-
27
-
28 entry({"about"}, template("about")).i18n = "admin-core"
-
29
-
30 local page = entry({"mini"}, alias("mini", "index"), i18n("essentials", "Essentials"), 10)
-
31 page.i18n = "admin-core"
-
32 page.sysauth = "root"
-
33 page.sysauth_authenticator = "htmlauth"
-
34 page.index = true
-
35
-
36 entry({"mini", "index"}, alias("mini", "index", "index"), i18n("overview"), 10).index = true
-
37 entry({"mini", "index", "index"}, form("mini/index"), i18n("general"), 1).ignoreindex = true
-
38 entry({"mini", "index", "luci"}, cbi("mini/luci", {autoapply=true}), i18n("settings"), 10)
-
39 entry({"mini", "index", "logout"}, call("action_logout"), i18n("logout"))
-
40 end
-
41
-
42 function action_logout()
-
43 luci.http.header("Set-Cookie", "sysauth=; path=/")
-
44 luci.http.redirect(luci.dispatcher.build_url())
-
45 end
这个文件定义了node，最外面的节点，最上层菜单的显示等等。在其他的lua文件里，定义了其他菜单的显示和html以及业务处理路径。每个文件对应一个菜单相。
例如 system.lua文件
-
function index()
-
19 luci.i18n.loadc("admin-core")
-
20 local i18n = luci.i18n.translate
-
21
-
22 entry({"mini", "system"}, alias("mini", "system", "index"), i18n("system"), 40).index = true
-
23 entry({"mini", "system", "index"}, cbi("mini/system", {autoapply=true}), i18n("general"), 1)
-
24 entry({"mini", "system", "passwd"}, form("mini/passwd"), i18n("a_s_changepw"), 10)
-
25 entry({"mini", "system", "backup"}, call("action_backup"), i18n("a_s_backup"), 80)
-
26 entry({"mini", "system", "upgrade"}, call("action_upgrade"), i18n("a_s_flash"), 90)
-
27 entry({"mini", "system", "reboot"}, call("action_reboot"), i18n("reboot"), 100)
-
28 end
mudel是对应文件的，function index定义了菜单，比如这一句entry({"mini", "system", "reboot"}, call("action_reboot"), i18n("reboot"), 100)
第1项为菜单入口：
{"mini", "system", "reboot"}，mini是最上层的菜单，即为用户项，system为一个具体的菜单，reboot为这个菜单的子菜单，如果reboot还需要加上子菜单的话，可以这样写：
entry({"mini", "system", "reboot"，"chreboot"}, call("action_chreboot"), i18n("chreboot"), 1),这样就会在reboot上产生一个新的子菜单，以此类推，可以产生N层菜单。
第二项为菜单对应的页面，可以是lua的源代码文件，也可以是html页面。
alias cgi form call 等定义了此菜单相应的处理方式，form和cgi对应到model/cbi相应的目录下面，那里面是对应的定制好的html和lua业务处理。
alias是等同于别的链接，call调用了相应的action_function。还有一种调用，是template，是直接链接到view相应目录下面的htm页面。（说明：luci框架下面的htm都是可以嵌入lua语句的，做业务处理，相当于jsp页面的内部的Java语句）。
问价查找对应简介：
entry({"mini", "system", "reboot"}, call("action_reboot"), i18n("reboot"), 100) ：对应此文件的action_reboot function
entry({"mini", "system", "index"}, cbi("mini/system", {autoapply=true}), i18n("general"), 1)：对应*/model/cbi/mini/system.lua {autoapply=true} 这个失传的参数。
。。。。。
第三项为i18n显示，比如entry({"mini", "system", "reboot"}, call("action_reboot"), i18n("reboot"), 100)，菜单的名字为admin-core文件内的对应显示。此处也可以这样写， i18n("reboot","重启")，即直接做了国际化。菜单上显示的就是“重启”。
第四项为现实的顺序，这个数字越小，显示越靠前，靠上。
现在说一下这些文件的解析是怎么解析的呢？你当然是说dispatch.lua中，你说对了，但是真正解析成菜单的递归算法确实在header.htm中
位置：*/view/themes/openwrt/
代码如下：
-
<%
-
require("luci.sys")
-
local load1, load5, load15 = luci.sys.loadavg()
-
local request = require("luci.dispatcher").context.path
-
local category = request[1]
-
local tree = luci.dispatcher.node()
-
local cattree = category and luci.dispatcher.node(category)
-
local node = luci.dispatcher.context.dispatched
-
local hostname = luci.sys.hostname()
-
local c = tree
-
for i,r in ipairs(request) do
-
if c.nodes and c.nodes[r] then
-
c = c.nodes[r]
-
c._menu_selected = true
-
end
-
end
-
require("luci.i18n").loadc("default")
-
require("luci.http").prepare_content("application/xhtml+xml")
-
-%>
-
"1.0" encoding="utf-8"?>
-
"-//W3C//DTD XHTML 1.0 Strict//EN" "">
-
"" xml:lang="<%=luci.i18n.context.lang%>" lang="<%=luci.i18n.context.lang%>">
-
-
"Content-Type" content="text/html; charset=utf-8" />
-
"Content-Script-Type" content="text/javascript" />
-
"stylesheet" type="text/css" media="screen" href="<%=media%>/cascade.css" />
-
-
-
<% if node and node.css then %>"stylesheet" type="text/css" media="screen" href="<%=resource%>/<%=node.css%>" />
-
<% end -%>
-
"text/javascript" src="<%=resource%>
-
"text/javascript" src="<%=resource%>
-
"text/javascript" src="<%=resource%>
-
<%=striptags( hostname .. ( (node <span class="keyword">and</span><span> node.title) </span><span class="keyword">and</span><span> </span><span class="string">' - '</span><span> .. node.title </span><span class="keyword">or</span><span> </span><span class="string">''</span><span>)) %> - LuCI
-
-
class="lang_<%=luci.i18n.context.lang%>">
-
class="skiplink">
-
"skiplink1">"#navigation" mce_href="#navigation"><%:skiplink1 Skip to navigation%>
-
"skiplink2">"#content" mce_href="#content"><%:skiplink2 Skip to content%>
-
-
"header">
-
<%=luci.version.distname%>
-
-
<%=luci.version.distversion%>
-
<%:load%>: <%="%.2f" % load1%> <%="%.2f" % load5%> <%="%.2f" % load15%>
-
<%:hostname%>: <%=hostname%>
-
-
"menubar">
class="navigation">"navigation" name="navigation"><%:navigation Navigation%>
"mainmenu" class="dropdowns">
<%-
local function submenu(prefix, node)
if not node.nodes or node.hidden then
return false
end
local index = {}
local count = 0
for k, n in pairs(node.nodes) do
if n.title and n.target then
table.insert(index, {name=k, order=n.order or 100})
count = count + 1
end
end
table.sort(index, function(a, b) return a.order < b.order end)
if count > 0 then
%>
"submenu_<%=string.gsub(string.gsub(prefix, "/", "_"), "^_(.-)_$", "%1")%>">
<%-
for j, v in pairs(index) do
if #v.name > 0 then
local nnode = node.nodes[v.name]
local href = controller .. prefix .. v.name .. "/"
href = (nnode.query) and href .. luci.http.build_querystring(nnode.query) or href
if nnode.nodes then
for k1, n1 in pairs(nnode.nodes) do
href = "#"
end
end
%>
if nnode._menu_selected then %> class="active"<%end%> href="<%=luci.util.pcdata(href)%>"><%=nnode.title%><%-
submenu(prefix .. v.name .. "/", nnode)
%>
<%-
end
end
%>
<%
end
end
if cattree and cattree.nodes then
local index = {}
for k, node in pairs(cattree.nodes) do
table.insert(index, {name=k, order=node.order or 100})
end
table.sort(index, function(a, b) return a.order < b.order end)
for i, k in ipairs(index) do
node = cattree.nodes[k.name]
if node.title and node.target and not node.hidden then
local href = controller.."/"..category.."/"..k.name.."/"
href = (k.query) and href .. luci.http.build_querystring(k.query) or href
for k1, n1 in pairs(node.nodes) do
if n1.title and n1.target then
href = " #"
end
end
%>
if node._menu_selected then %> class="preactive"<%end%> href="<%=href%>"><%=node.title%><%
submenu("/" .. category .. "/" .. k.name .. "/", node)
%><%
end
end
end
%>
"modemenu"><%
for k,node in pairs(tree.nodes) do
if node.title and not node.hidden then %>
if request[1] == k then %> class="active"<%end%> href="<%=controller%>/<%=k%>/"><%=node.title%><%
end
end
%>
<%
if tree.nodes[category] and tree.nodes[category].ucidata then
local ucic = 0
for i, j in pairs(require("luci.model.uci").cursor():changes()) do
for k, l in pairs(j) do
for m, n in pairs(l) do
ucic = ucic + 1;
end
end
end
-%>
"savemenu" class="dropdowns">
<% if ucic > 0 then %>class="warning" href="<%=controller%>/<%=category%>/uci/changes/"><%:unsavedchanges%>: <%=ucic%><%
submenu("/" .. category .. "/uci/", tree.nodes[category].nodes["uci"])
else -%>
"#" mce_href="#"><%:changes%>: 0<% end -%>
<% end %>
class="clear">
