牽著老婆滿街逛

嚴(yán)以律己,寬以待人. 三思而后行.
GMail/GTalk: yanglinbo#google.com;
MSN/Email: tx7do#yahoo.com.cn;
QQ: 3 0 3 3 9 6 9 2 0 .

導(dǎo)航

<

2006年8月

>

日

一

二

三

四

五

六

30

31

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

21

27

29

30

31

1

2

3

4

5

6

7

8

9

統(tǒng)計(jì)

隨筆 - 1513
文章 - 45
評(píng)論 - 907
引用 - 0

公告

言論：
1.每日自省；
2.享受人生；
3.盡力而為；
4.堅(jiān)持不懈；
5.切莫急躁；
6.慎言敏行；
7.動(dòng)心忍性；
8.上善若水。

常用鏈接

留言簿(11)

隨筆分類(466)

隨筆檔案(1513)

文章分類(46)

文章檔案(45)

相冊(cè)

收藏夾(39)

搜索

積分與排名

積分 - 2523555
排名 - 2

閱讀排行榜

[轉(zhuǎn)載] 如何制作Webmin(Unix上的GUI管理工具)模塊

本文著重探討 Webmin的技術(shù)內(nèi)幕和如何編寫 Webmin模塊。文中首先介紹剖析了 Webmin內(nèi)部結(jié)構(gòu)，然后在 Webmin發(fā)行包基礎(chǔ)上了裁減出了一個(gè) Webmin的核心，最后介紹如何編寫一個(gè) Webmin模塊。
剖析Webmin 的內(nèi)部結(jié)構(gòu)
解開(kāi) Webmin的安裝包，可以發(fā)現(xiàn)Webmin 的目錄的組成如下：

一組子目錄，很顯然這些子目錄絕大多數(shù)都是一個(gè)Webmin 管理模塊，而且可以看出Webmin完全由 perl實(shí)現(xiàn)；
一組perl腳本和幾個(gè)CGI 腳本，這些腳本可以分為三類：
內(nèi)置的HTTP服務(wù)器：它支持 CGI，Session 和SSL等功能。Miniserv.pl 和miniserv.pem實(shí)現(xiàn)了這個(gè) HTTP服務(wù)器。它的配置文件通常是/etc/webmin/miniserv.conf, 它主要有如下幾個(gè)重要參數(shù)：參數(shù)及缺省值說(shuō)明
port=10000 設(shè)置 HTTP服務(wù)器監(jiān)聽(tīng)的端口
root=/usr/libexec/webmin Web 文件的根目錄
ssl=0 是否支持 SSL,如果設(shè)置為1 ，這個(gè)HTTP服務(wù)器將提供HTTPS 服務(wù)
session=1 是否支持 Session,如果設(shè)置為1 ，在訪問(wèn)Web服務(wù)之前必須先完成用戶登錄和認(rèn)證，用戶的登錄和認(rèn)證由 session_login.cgi實(shí)現(xiàn)
userfile=/etc/webmin/miniserv.users 存放 HTTP服務(wù)器的用戶名和密碼，changepass.pl 可以修改用戶密碼
keyfile=/etc/webmin/minserv.pem 存放 HTTP服務(wù)器的私鑰和公鑰證書(shū)

Webmin 核心：這部分包括Webmin核心庫(kù)、 Webmin的首頁(yè)和模塊管理。Web-lib.pl 是Webmin的核心庫(kù)，包含了 Webmin中主要的公用函數(shù)。Web-lib.pl 中會(huì)引用了一些CGI提供一些公用功能，這些 CGI包括: chooser.cgi 文件選擇 Frame
date_chooser.cgi 日期選擇 Frame
config.cgi 配置模塊配置文件頁(yè)面
config_save.cgi 保存配置
help.cgi 幫助頁(yè)面
fastrpc.cgi 啟動(dòng)一個(gè)新進(jìn)程以加快 rpc的調(diào)用
rpc.cgi 用于截獲其他 Webmin服務(wù)器發(fā)來(lái)的Webmin 遠(yuǎn)過(guò)程調(diào)用
referer_save.cgi Redirect 到以前的URL
user_chooser.cgi 用戶選擇 Frame
switch_user.cgi 切換用戶
switch_skill.cgi 改變當(dāng)前 Webmin用戶的Skill level
acl_security.cgi 配置全局 ACL選項(xiàng)

index.cgi 實(shí)現(xiàn)Webmin的首頁(yè)，它將當(dāng)前用戶可以使用的管理模塊按類別分為一個(gè)屬性頁(yè)顯示。

Install-Module.pl 用于從命令行安裝一個(gè)Webmin的管理模塊。它調(diào)用了 copyconfig.pl和perlpath.pl 。

安裝腳本：這些腳本用于安裝配置Webmin 。Setup.pl是主要的配置腳本，它調(diào)用如下腳本：

腳本說(shuō)明
newmods.pl 用于初始化一個(gè)新插入模塊的配置文件
oschooser.pl 選擇操作系統(tǒng)類型
copyconfig.pl 給管理模塊復(fù)制配置文件
thirdparty.pl 檢查已經(jīng)安裝的模塊
perlpath.pl 當(dāng) perl的路徑不是/usr/local/bin/perl 時(shí)，替換perl腳本中的#!/usr/local/bin/perl

裁減出Webmin 的核心
Webmin的開(kāi)發(fā)目的是建立一個(gè) Web界面的UNIX 系統(tǒng)管理工具，所以Webmin的發(fā)行版中不僅包含了 Webmin的工作核心，而且包含了大量的管理模塊。而實(shí)際上裁減出一個(gè) Webmin的核心也是件很有意義的事情，這主要體現(xiàn)在下面兩個(gè)方面：

一般Webmin的自帶的管理模塊并不需要同時(shí)存在，能夠需要什么模塊時(shí)插入才是比較理想的做法
Webmin 核心為我們提供了一個(gè)支持認(rèn)證和訪問(wèn)控制的Web 服務(wù)器和一套有效合理的開(kāi)發(fā)小型Web應(yīng)用的程序框架。

基于以上原因，筆者裁減出了一個(gè) Webmin的核心并命名為webmin-platform 。和Webmin的發(fā)行版相比， Webmin-Platform具有如下特點(diǎn)：
短小精湛，webmin-platform的安裝包只有 100多K, 缺省只包括Webmin配置和用戶管理兩個(gè)模塊。 Webmin的其他模塊可以順利加入。
缺省情況下把Webmin的配置文件和 log文件都設(shè)置在安裝目錄，減少了對(duì)UNIX 系統(tǒng)的依賴性。

讓筆者比較遺憾的是，目前 Webmin不支持Win32 平臺(tái)，因此webmin-platform也不支持 Win32平臺(tái)。有興趣的讀者，可以嘗試把webmin-platform 移植到Windows平臺(tái)。

Webmin模塊
Webmin模塊實(shí)際上是一個(gè)壓縮過(guò)的 TAR包，你可以通過(guò)tar zxvf 命令解開(kāi)任何一個(gè)Webmin模塊包。一般 Webmin模塊的結(jié)構(gòu)如下所示：

目錄或文件說(shuō)明
index.cgi 該模塊的首頁(yè)
config 缺省的配置文件
config.info 對(duì)配置文件中配置選項(xiàng)的說(shuō)明
module.info 對(duì)模塊的說(shuō)明，包括模塊名 (name)、模塊描述(desc) 、類別(category)、依賴 (dependency)和模塊版本（version ）。
acl_security.pl 模塊的訪問(wèn)控制
image/ 存放模塊中用到的圖片
lange/ 存放頁(yè)面信息中的各種語(yǔ)言版本

Webmin模塊中的 CGI腳本一般都具有相似的結(jié)構(gòu)，下面將通過(guò) Webmin技術(shù)文檔中模板文件為例來(lái)說(shuō)明這種結(jié)構(gòu)：

#!/usr/bin/perl
#這是Webmin模塊的一個(gè)模板
do '../web-lib.pl';
&init_config();
%access=&get_module_acl;
&ReadParse();
##檢查訪問(wèn)控制(ACL)

##頁(yè)眉
&header($text{'index_title'}, "", "intro", 1, 1, undef,
"Written by<lt;BR>;<lt;A HREF=mailto:author\@email>;Author<lt;/A>;<lt;BR>;<lt;A HREF=http://www.authorpage>;Home://page<lt;/A>;"

;

##在這插入你的代碼
##輸出一個(gè)表格
print "<lt;table>;",
"<lt;tr $tb>;<lt;td>;$text{'title'}<lt;/td>;<lt;/tr>;\n",
"<lt;tr $cb>;<lt;td>;$text{'prject1'}<lt;/td>;<lt;/tr>;\n",
"<lt;/table>;";

##頁(yè)腳
&footer("/", $text{'index'});

##模塊中的子函數(shù)放在這里

### END of index.cgi ###.

這個(gè)模板文件結(jié)構(gòu)很清晰，它依次由下面幾部分組成：

Webmin 中的腳本文件必須包含Webmin根目錄下的 web-lib.pl。web-lib.pl 是Webmin提供的支持庫(kù)，所有的 Webmin的API 函數(shù)都在這個(gè)文件中定義。
模板文件首先調(diào)用init_config獲取本模塊的配置選項(xiàng)
接著需要調(diào)用get_module_acl獲取訪問(wèn)控制表
調(diào)用ReadParse函數(shù)將 HTTP請(qǐng)求的參數(shù)編譯到關(guān)聯(lián)數(shù)組%in 中
下面就可以檢查當(dāng)前用戶是否具有訪問(wèn)這個(gè)頁(yè)面的權(quán)限了
以上是初始化工作，下面可以輸出頁(yè)面了。函數(shù)header 由Webmin提供，它打印出一個(gè)標(biāo)準(zhǔn)的 Webmin頁(yè)眉
在輸出你自己的頁(yè)面內(nèi)容后，可以調(diào)用footer 函數(shù)打印出Webmin標(biāo)準(zhǔn)的頁(yè)腳。
下面幾小節(jié)闡述編寫Webmin模塊涉及的幾個(gè)主要問(wèn)題。

這個(gè)模板文件結(jié)構(gòu)很清晰，它依次由下面幾部分組成：

Webmin 中的腳本文件必須包含Webmin根目錄下的 web-lib.pl。web-lib.pl 是Webmin提供的支持庫(kù)，所有的 Webmin的API 函數(shù)都在這個(gè)文件中定義。
模板文件首先調(diào)用init_config獲取本模塊的配置選項(xiàng)
接著需要調(diào)用get_module_acl獲取訪問(wèn)控制表
調(diào)用ReadParse函數(shù)將 HTTP請(qǐng)求的參數(shù)編譯到關(guān)聯(lián)數(shù)組%in 中
下面就可以檢查當(dāng)前用戶是否具有訪問(wèn)這個(gè)頁(yè)面的權(quán)限了
以上是初始化工作，下面可以輸出頁(yè)面了。函數(shù)header 由Webmin提供，它打印出一個(gè)標(biāo)準(zhǔn)的 Webmin頁(yè)眉
在輸出你自己的頁(yè)面內(nèi)容后，可以調(diào)用footer 函數(shù)打印出Webmin標(biāo)準(zhǔn)的頁(yè)腳。

下面幾小節(jié)闡述編寫Webmin模塊涉及的幾個(gè)主要問(wèn)題。

統(tǒng)一的界面風(fēng)格
Webmin要求形形色色的模塊具有相同的界面風(fēng)格和統(tǒng)一的色彩方案。為了達(dá)到這種效果，所有模塊應(yīng)該遵循如下規(guī)則：

所有支持image、table 和form的瀏覽器都能夠正確顯示管理頁(yè)面。應(yīng)該盡量避免使用 frame、DHTML 、JavaScript和Java 等和瀏覽器相關(guān)的特征；
所有產(chǎn)生HTML頁(yè)面的CGI 程序都應(yīng)該調(diào)有header生成頁(yè)頭。它會(huì)生成一個(gè)顯示頁(yè)面主題的圖片，還可能會(huì)加入一些主要的連接。所有這些 CGI都應(yīng)該保持字體類型、大小和風(fēng)格的一致性；
應(yīng)該使用$tb作為表格頭的背景色，使用 $cb作為表格體的背景色。就像模板文件中的輸出表格語(yǔ)句那樣；
應(yīng)該避免在Form中包含大量的輸入控件，一些 UNIX的瀏覽器處理這樣的Form 時(shí)會(huì)比較慢；

國(guó)際化支持
Webmin提供國(guó)際化支持。任何希望支持國(guó)際化的模塊都應(yīng)該包含子目錄 lang。lang 目錄中包含不同國(guó)家語(yǔ)言的系統(tǒng)消息翻譯文件。這個(gè)文件中每一行包含一個(gè)消息的定義：

message_code=Message in this language

Webmin 根目錄下的lang_list.txt包含了現(xiàn)在支持的語(yǔ)言和支持的編碼格式。因?yàn)閃ebmin 的缺省語(yǔ)言是英語(yǔ)，所以消息翻譯文件lang/en很特殊。當(dāng)找不到某消息的某語(yǔ)言版本時(shí)會(huì)用它的英語(yǔ)版本代替。簡(jiǎn)體中文的翻譯文件是 lang/zh_CN。

當(dāng)使用在頁(yè)面中使用國(guó)際化的消息時(shí)應(yīng)該使用 Wembin定義的關(guān)聯(lián)數(shù)組$text。如當(dāng)前 Webmin使用簡(jiǎn)體中文，某模塊的簡(jiǎn)體中文消息文件中包括：

index_title=我喜歡Webmin

那么 CGI程序中

print $text{" index_title" };

的輸出是：

我喜歡Webmin

模塊的配置
Webmin中的配置參數(shù)分為全局參數(shù)和模塊參數(shù)。全局配置參數(shù)缺省放在 /etc/webmin/config中，模塊配置參數(shù)缺省放在 /etc/webmin/$MODULENAME/config 中。在CGI中調(diào)用init_config 函數(shù)可以全局配置參數(shù)讀入到關(guān)聯(lián)數(shù)組%gconfig ，把模塊配置參數(shù)讀入到關(guān)聯(lián)數(shù)組%config 中。

一個(gè)完整的模塊應(yīng)該具有 config.info文件，它定義了模塊配置參數(shù)的信息。 Webmin根目錄下的config.cgi 使用這個(gè)文件產(chǎn)生修改模塊配置參數(shù)的頁(yè)面。config.info 中每一行說(shuō)明一個(gè)參數(shù)的信息：

config_name=description,type[,values]

config_name 定義了配置參數(shù)的描述，description 定義配置參數(shù)的說(shuō)明，type定義配置參數(shù)值的類型， values定義配置參數(shù)的缺省值。

同一個(gè)模塊可能在不同的 UNIX系統(tǒng)中具有不同的缺省配置。所以完整的模塊還應(yīng)該包含不同操作系統(tǒng)的缺省配置文件。這些配置文件的命名規(guī)則是：

config-osname-osversion
config-osname
config

Webmin目錄下的 os_list.txt列出了當(dāng)前Webmin 支持的UNIX系統(tǒng)

訪問(wèn)控制
Webmin支持基于模塊的用戶訪問(wèn)控制。 /etc/webmin/webmin.acl文件定義了 webmin用戶可以訪問(wèn)的模塊。如果想實(shí)現(xiàn)更小粒度的訪問(wèn)控制，可以使用 Webmin提供的基于模塊操作的用戶訪問(wèn)控制。在模塊的配置目錄下， Webmin會(huì)為每個(gè)用戶生成一個(gè)訪問(wèn)控制文件，它通常被命名為 $username.acl (如root.acl) 。模塊可以編寫acl_security.pl 來(lái)操作這個(gè)文件。Webmin要求 acl_security.pl定義兩個(gè)函數(shù)操作模塊訪問(wèn)控制文件：

acl_security_form(acl) ：該函數(shù)輸出一個(gè)HTML的表格項(xiàng)。這個(gè)函數(shù)的輸出提供給管理員修改某個(gè)用戶對(duì)模塊某個(gè)操作的訪問(wèn)權(quán)限。
acl_security_save(acl,input) ：這個(gè)函數(shù)可以在保存管理員對(duì)訪問(wèn)權(quán)限修改前做些必要的操作。

如果沒(méi)有 acl_security.pl，Webmin 會(huì)提供一個(gè)缺省的訪問(wèn)控制參數(shù)isconfig ，它指定一個(gè)用戶是否擁有修改模塊配置參數(shù)的權(quán)限。

如模板文件所示， CGI程序調(diào)用get_module_acl 把當(dāng)前用戶的訪問(wèn)權(quán)限讀入一個(gè)關(guān)聯(lián)數(shù)組。下面是在程序檢測(cè)用戶訪問(wèn)權(quán)限的例子：

#!/usr/local/bin/perl

require './foo-lib.pl';

%access = &get_module_acl();

$access{'create'} || &error("You are not allowed to create new foo users"

;

其他問(wèn)題
前幾節(jié)闡述了編寫 Webmin模塊需要涉及的幾個(gè)常見(jiàn)問(wèn)題。下面是一些沒(méi)有涉及到的問(wèn)題：

文件加鎖
活動(dòng)日志
在線幫助
用戶更新通知
界面主題

關(guān)于這些問(wèn)題，請(qǐng)參閱 Webmin模塊編寫幫助。

常用函數(shù)
最后簡(jiǎn)單的列舉編寫 Webmin模塊經(jīng)常用到的函數(shù)和全局變量：

ReadParseMime：編譯具有MIME 參數(shù)的HTTP請(qǐng)求參數(shù)
file_chooser_button：返回一個(gè) JavaScript按鈕，它允許用戶選擇一個(gè) Webmin服務(wù)器上的一個(gè)文件
user_chooser_button：返回一個(gè) JavaScript按鈕，它允許用戶選擇一個(gè) Webmin服務(wù)器上的系統(tǒng)用戶
group_chooser_button：返回一個(gè) JavaScript按鈕，它允許用戶選擇一個(gè) Webmin服務(wù)器上的用戶組
$module_name：當(dāng)前模塊的名稱
$module_config_directory：當(dāng)前模塊的配置文件目錄

結(jié)語(yǔ)
可插入模塊機(jī)制為 Webmin帶來(lái)了極大的可擴(kuò)展性，也使得用戶可以方便的定制自己的管理模塊。同時(shí)利用 Webmin平臺(tái)構(gòu)造一些小型的Web 應(yīng)用也是個(gè)不錯(cuò)的選擇。

posted on 2007-04-29 20:45 楊粼波閱讀(657) 評(píng)論(0) 編輯收藏引用

只有注冊(cè)用戶登錄后才能發(fā)表評(píng)論。
【推薦】100%開(kāi)源！大型工業(yè)跨平臺(tái)軟件C++源碼提供，建模，組態(tài)！



網(wǎng)站導(dǎo)航: 博客園 IT新聞 BlogJava 博問(wèn) Chat2DB 管理

青青草原综合久久大伊人导航_色综合久久天天综合_日日噜噜夜夜狠狠久久丁香五月_热久久这里只有精品

牽著老婆滿街逛

導(dǎo)航

統(tǒng)計(jì)

公告

常用鏈接

留言簿(11)

隨筆分類(466)

隨筆檔案(1513)

文章分類(46)

文章檔案(45)

相冊(cè)

收藏夾(39)

工具官網(wǎng)

技術(shù)網(wǎng)站

開(kāi)源網(wǎng)站

其他窩點(diǎn)

收藏網(wǎng)站

銀行官網(wǎng)

友情鏈接

資源共享

搜索

積分與排名

最新評(píng)論

閱讀排行榜

[轉(zhuǎn)載] 如何制作Webmin(Unix上的GUI管理工具)模塊