a高清免费毛片久久,久久人人爽人人爽人人片AV东京热 ,久久综合久久美利坚合众国

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

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

一組子目錄，很顯然這些子目錄絕大多數(shù)都是一個Webmin 管理模塊，而且可以看出Webmin完全由 perl實(shí)現(xiàn)；
一組perl腳本和幾個CGI 腳本，這些腳本可以分為三類：
內(nèi)置的HTTP服務(wù)器：它支持 CGI，Session 和SSL等功能。Miniserv.pl 和miniserv.pem實(shí)現(xiàn)了這個 HTTP服務(wù)器。它的配置文件通常是/etc/webmin/miniserv.conf, 它主要有如下幾個重要參數(shù)：參數(shù)及缺省值說明
port=10000 設(shè)置 HTTP服務(wù)器監(jiān)聽的端口
root=/usr/libexec/webmin Web 文件的根目錄
ssl=0 是否支持 SSL,如果設(shè)置為1 ，這個HTTP服務(wù)器將提供HTTPS 服務(wù)
session=1 是否支持 Session,如果設(shè)置為1 ，在訪問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ù)器的私鑰和公鑰證書

Webmin 核心：這部分包括Webmin核心庫、 Webmin的首頁和模塊管理。Web-lib.pl 是Webmin的核心庫，包含了 Webmin中主要的公用函數(shù)。Web-lib.pl 中會引用了一些CGI提供一些公用功能，這些 CGI包括: chooser.cgi 文件選擇 Frame
date_chooser.cgi 日期選擇 Frame
config.cgi 配置模塊配置文件頁面
config_save.cgi 保存配置
help.cgi 幫助頁面
fastrpc.cgi 啟動一個新進(jìn)程以加快 rpc的調(diào)用
rpc.cgi 用于截獲其他 Webmin服務(wù)器發(fā)來的Webmin 遠(yuǎn)過程調(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的首頁，它將當(dāng)前用戶可以使用的管理模塊按類別分為一個屬性頁顯示。

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

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

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

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

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

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

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

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

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

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

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

##頁眉
&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>;"

;

##在這插入你的代碼
##輸出一個表格
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>;";

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

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

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

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

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

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

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

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

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

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

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

message_code=Message in this language

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

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

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 中。

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

config_name=description,type[,values]

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

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

config-osname-osversion
config-osname
config

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

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

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

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

如模板文件所示， CGI程序調(diào)用get_module_acl 把當(dāng)前用戶的訪問權(quán)限讀入一個關(guān)聯(lián)數(shù)組。下面是在程序檢測用戶訪問權(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"

;

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

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

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

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

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

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

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

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



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

牽著老婆滿街逛

導(dǎo)航

統(tǒng)計(jì)

公告

常用鏈接

留言簿(11)

隨筆分類(466)

隨筆檔案(1513)

文章分類(46)

文章檔案(45)

相冊

收藏夾(39)

工具官網(wǎng)

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

開源網(wǎng)站

其他窩點(diǎn)

收藏網(wǎng)站

銀行官網(wǎng)

友情鏈接

資源共享

搜索

積分與排名

最新評論

閱讀排行榜

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