与 HTML相结合的资料库 --- MiniSQL 2.0 Beta 7 & W3-mSQL 2.0 Beta

与 HTML相结合的资料库 --- MiniSQL 2.0 Beta 7 & W3-mSQL 2.0 Beta

看了半年的 ISDN介绍，您是否对 ISDN有一番了解了呢？是否还有其他的问题？本期作者收集了一些读者最常会遇到的问题，看看里面是否有您需要的解答！

本文作者 : 周树禾

Mini SQL 简介与功能说明

笔者又来介绍另一款 Linux上的资料库给各位啦！若是读者有印象，笔者曾在上上期中介绍过 Postgres95给各位，这次笔者要介绍的是较适合於一般个人使用的小型资料库软体 ---Mini SQL 2.0，笔者之所以要介绍这一套软体的主要原因在於，它能够与 HTML轻易地结合在一起，不需要再写 CGI程式了。若是读者们用过 Windows NT的 ASP (Active Server Page)，对於这种将程式直接写入 Homepage的方式应该能马上感受到它方便的所在了。其实 Mini SQL能够具备这个功能得归功於 W3-mSQL，这是一款与 Mini SQL bundled 在一起的程式，其功能与使用方法待後详述！

废话不多说了，开始正式介绍一下 Mini SQL 吧！ Mini SQL（下文简称 mSQL）是一套小型的资料库软体，它当初设计的主要目标在於能够在资料量不大的情况下很快速地存取资料，这个特性也正好符合一般个人使用者与讲究反应速度的 WW-W 环境的要求，而本文所介绍的 2.0版本仍朝着更强大的功能改进着。 mSQL不但资料库处理的速度快，还有许多方便的支援特性，使得它不光只是单纯的资料库系统而已，其中一点就是它有自己的发展语言 Scripting Language---Lite，这是一种非常类似 C语言的 Script我们可以很轻松简单地用这种 Script来发展我们的应用程式。另外还值得一提的是 W3-mSQL中所使用的语言也是 Lite喔！以上大略介绍了一下 mSQL较为特别的几点，可别以为它就只能用她独有的 Lite来写程式喔，除了 Lite之外， mSQL也有提供 C， ESL， Perl 5， Python与 TCL等 API给各类不同喜好的程式设计师们应用；不过有一点是必须强调的， mSQL并非是完全的 freeware，若您是在大学中使用此一软体，或是为了学术研究与慈善等非营利性目的，才能免费得到使用权（ free license），否则您就得付费注册才能得到正式的版权了。也因此我们安装的这套 mSQ-L只有 30天的使用期限，若您觉得它还满好用的，可别忘了赶紧去注册喔！

Mini SQL 安装与测试

笔者在国内各大 ftp site都没找到最新版本的 mSQL，不得已只好直接到 http://www.hughes.c-om.au去抓回来最新的 2.0 Beta 7.1版，之後再以 tar解开，进入 msql-2.0-B7.1目录中正式开始我们安装的步骤：

（ 1）下 make target命令会针对作业系统来建立 targets目录，若正确完成此一动作，将会多出 targets目录，而且 targets目录里会有以您作业系统名称及版本为名字之目录，例如笔者的 slackware-96即为 targets/Linux-2.0.0-i486/。

(执行画面如图一 ) (图一 ) skytree:/tmp/msql-2.0-B7.1# make target

Making target directory for Linux-2.0.0-i486

Building directory tree.

Adding common

Adding conf

Adding lang-common

Adding lite

Adding makedepend

Adding makegen

Adding msql

Adding regexp

Adding tests

Adding tests/rtest.src

Adding tests/rtest-old

Adding w3-msql

Adding w3-msql/tests

Adding sym-links

...........................................................................................................................................................................

Build of target directory for Linux-2.0.0-i486 complete

----------------------------------------------------------------------------

（ 2）进入 targets/Linux-2.0.0-i486/目录中，并且下 ./setup执行编译程式前的设定工作．将会检查系统安装情形来建立编译程式所需要的一些设定档案。

(图二 )

skytree:/tmp/msql-2.0-B7.1/targets/Lin-ux-2.0.0-i486# ./setup

Starting configuration of mSQL 2.

checking for gcc

checking for return type of signal handlers

checking for ranlib

...

... (略 )

...

creating config.status

creating site.mm

creating makegen/makegen.cf

creating common/config.h

checking your directory stuff.Using dirent.h and struct dirent

checking mmap().Your mmap() is fine.

checking for sys_errlist. You’ re fine.

checking for u_int. You’ re fine.

checking for int32_t and friends.You’ re fine.

checking for ssize_t. You’ re fine.

checking for a working getrlimit.You’ re fine.

Ready to build mSQL.

You may wish to check “ common/site.h” although the defaults should be fine.

When you’ re ready, type“ make all” to build the software

----------------------------------------------------------------------------

（ 3）此时系统内定是安装到 /usr/local/Hughes/目录中，若您想改变安装後系统的目录可以编辑 site.

mm这个档案，将 INST_DIR=/usr/local/Hughes修改成 INST_DIR=您所想安装到的绝对路径名称即可。否则可直接做下一步骤。

（ 4）下 make all命令开始编译程式。

(图叁 )

skytree:/tmp/msql-2.0-B7.1/targets/Lin-ux-2.0.0-i486# make all

Regenerating Makefile.

.................................................................

Done.

make[1]:Entering directory`/tmp/msql-2.0-B7.1/targets/Linux-2.0.0-i486’

Starting make for mSQL-2

--＞ [common] directory

make[2]:Entering directory

`/tmp/msql-2.0-B7.1/targets/Linux-2.0.0-i486/common’

...

... (略 )

...

Make of mSQL-2 complete.

You should now install mSQL-2 using make install

make[1]:Leaving directory`/tmp/msql-2.0-B7.1/targets/Linux-2.0.0-i486’

----------------------------------------------------------------------------

（ 5）若以上步骤皆没问题，先恭喜您已经安装了一半啦！再来就是下 make install来将编译好的程式放置到正确的目录之中了。这一步骤最好以 root 来执行才不会出错！

（ 6）现在我们可以编辑 /usr/local/Hughes/msql.c-onf，这是 mSQL的设定档，其中包含了一些重要的设定资料，说明如下：

[general]

Inst_Dir = /usr/local/Hughes ( 系统安装的绝对路径）

mSQL_User=msql（ mSQL的使用者帐号，内定为 msql）

Admin_User=root（ mSQL的管理者帐号，内定为 root，具有建立新资料库，关闭 mSQL系统的权限等等 ......）

Pid_File=%I/msql2d.pid（将存放msql 2d启动後的 pid）

...以下省略 ...可不用修改

（7）若您系统中无上步骤中 mSQL_User=msql所设定的使用者帐号，请以 adduser来新增 msql使用者帐号，并将系统安装的目录以 chown-Rmsql/us-r/local/Hughes将系统档案所有人更换为 msql，等一下启动系统时才不会发生错误。

（ 8）现在你可以下 /usr/local/Hughes/bin/msql2d &启动了！启动後（画面如图四），将会以 /usr/loc-al/Hughes/msql.conf为控制档，并以 msql为此 daemon的所有人；此外还会警告您未找到 ACL（ Access Control）档案（此为一控制资料库存取权限的设定档，待後详述），将不限制存取权限，即表示任何人皆可存取您的资料库。

(图四 )

skytree:/usr/local/Hughes#./bin/msql2d&

[1]24568

skytree:/usr/local/Hughes#

Mini SQL Version 2.0 Beta 7

Loading configuration from‘ /usr/local/Hughes/msql.conf’ .

Server process reconfigured to acc- ept 214 connections.

Server running as user‘ msql’ .

This Beta test release expires in 28 days.

Warning : No ACL file. Using global rea-d/write access.

----------------------------------------------------------------------------

（ 9）再来我们必须以 msql Root_User的身分（於 msql.conf中所设定的管理者帐号 )来执行 /usr/loc-al/Hughes/misc/setup_www，安装 W3-mSQL到系统中。

（ 10）将 /usr/local/Hughes/bin目录中的 w3-auth与 w3-msql拷贝到您的 cgi-bin目录中，之後才能使用 W3-mSQL，使用的方式待後详述。另外 W3-mS-QL提供了一个程式范例，是关於 bookmarks资料库的，您可以 cp-r/usr/local/Hughes/www/bookmarks~/httpd/htdocs把此一范例安装到您的 Web Server上！若动作正确，您可以在 http://your.host/bookmarks/Welcome.html中看到如图五的画面。以上十个步骤，已大略将整个资料库系统与 W3-mSQL安装完成了！我们可以先来测试一下：

1.开启 WWW浏览器， open URL： http： //your host/bookmarks/Welcomes.html，若正确者，应看见画面如图五。

2.点取 Browse the Bookmarks Database将看见画面如图六。

3.点取 Create，再输入 New Bookmark Title， URL後，按下 Create Bookmark。如图七。

4.结果应该如图八，我们已加入了一个新的 Book-mark到范例资料库中了。

5.再点选 Back，将发现我们新加入的 Bookmark已出现在画面上。至此，测试的工作已完成了。您可以依照着画面上的指示试试 Delete与 Search的功能喔！

Mini SQL的系统设定 copyC:\HE-5\AUTOS-AVE\DDD.TXTC:\38\S-KYTREE\DDD.TXT

这一部份将帮助读者进一步了解 Mini SQL 这个软体的运作与一些该注意的地方。将分成两个部份来说明：

（ 1） Run-Time Configuration

其实就是在安装步骤 6）中所提到的 msql.co-nf设定档的内容， msql.conf必须放置於安装系统时的系统目录中，在本篇文章中即 /usr/local/Hug-hes，我们可以使用一般的文书编辑器直接来修改这个文字档案，并储存即可。在此设定档中，％ I

代表的意义是系统目录（ e.g./usr/local/Hughes）。这个档案里各项设定的意义与功能如下表：

（ 2） ACL（ Access Control）

在安装步骤 8）启动 mSQL Server後，如图

四可见 Warning∶ No ACL file.Using global re-ad/write access.

即是缺乏 ACL档案，才会产生此警告，先简单说明一下 ACL的功能吧！ ACL其实是一个设定 mSQL Server存取权限的档案，因为 mSQL并不提供连线时确认使用者身分的功能，所以必须依靠 ACL档案来控制使用者对资料库的动作权限。

这个 ACL档案必须放置在系统目录中（ /usr/local/Hughes），取名为 msql.acl，原本在此目录中已有一个范例档案 -msql.acl.sample，我们可以直接拷贝成 msql.acl并确定其 owner为 msql即可。图九为 msql.acl.sample的内容，我们就针对这内容来讲解该如何设定好我们的 mSQL资料库权限。

(图九 )

# Access control for mSQL

# Entries are of the form

database=test

read=bambi,-root

write=root

host=*

access=local,remote

option=rfc931

database=minerva

read=*

write=minerva

access=local

----------------------------------------------------------------------------

test与 minerva为所要设定权限的资料库名称， bambi可读取 test， root则不可读取 test资料库，但是却可写入 test资料库， host=*则是表示所有网路上的主机皆可与此资料库连线，若写成 ho-st=*.yzit.edu.tw则代表於 yzit.edu.tw domain下的主机才能够与此资料库连线。 access=local表示只有 local端程式才能够存取此资料库。若想使已启动的系统更新为 ACL设定值，可以使用 /usr/local/H-ughes/bin/msqladmin reload即可更新系统状态为新的设定值。

Lite:MiniSQL的 Scripting Lang-uage

Mini SQL拥有自己的一种 Script语言，称做 Lite，可用来做为与其资料库沟通的工具，等会儿要介绍的 W3-mSQL也是使用 Lite喔！若是读者学过 C语言的话，笔者先在这里恭喜您罗！因为 Lite 的语法与 C语言只有几点不同，其馀几乎都是相同的，除此之外 Lite也有与 Perl相同之处，即变数不用宣告，即可以直接在程式之中使用喔！底下笔者先说明一下 Lite与 C不同之处：

1.记忆体的管理不需要程式本身来操心，由 Lite Virtual Machine来自行控制。

2.变数并无固定的型态。

3.有动态的阵列型态，简单的说就是阵列中的每个元素都可以是不同的型态。

4.变数不需事先宣告即可直接使用。

5.变数的名称必须以＄为开头字元，且＄後的第一个字元不可为大写的字元。例如：＄skytree，＄ y-zit为合法变数名称，而 skytree，＄ Yzit则不合法。

Lite的变数型态，有以下叁种：

1.char(字元 ,字串型态 ) ex:＄ skytree_1=“ skytree” ；

2.integer(整数型态 ) ex:＄ skytree_2= 100； 3.real number(实数型态 ) ex:＄ skytree_4= 12.627；

变数型态可以直接做转换，例如：

＄ skytree_2=100；

＄ skytree_1=(char)＄ skytree_2；

则＄ skytree_1就等於 “ 100” ，此外，字串也可以直接做相加的动作，例如：

＄ skytree_1=“ YZIT” ＋ “ _CNPA” ；

则＄ skytree_1就等於 “ YZIT_CNPA” 。

Lite的运算元 (operator)：

包含了＋，－，＊，／与一个非常特殊的＃，＋， m，＊，／这四个数学运算元中，除了＋多具备了字串串接的功能外，其馀皆与一般数学运算元无异。而＃为 Lite本身较为特殊的一个运算元，它的功能是能够求得某个变数内容的大小，若其後变数型态为字串，则传回字元的总数；若为阵列，则传回阵列中的元素总数，举例来说：

＄ skytree=“ skytree” ；

＄ cnpa=＃＄ skytree；

＄ array[0]=0；

＄ array[1]=1；

＄ array[2]=2；

＄ num=＃＄ array；

则＄ cnpa就等於 7，因为 skytree共有 7个字元；而＄ num就等於 3，因为＄ array阵列中共有 3个元素。

在 C语言中，若是一行之内可以直接写完的叙述，可以不用｛｝括起来，但是在 Lite中则不行，不管叙述为多少行都得以｛｝括起来，例如：

if（ a＞ b） printf（ “ a＞ b” ）；

在 C语言中是允许的，但是若以 Lite来写，则一定得写成

if（＄ a＞＄ b）

｛

printf（ “ a＞ b” ）；

｝

另外， Lite只支援 while这一种回圈（也包含了 break与 continue），这一点是用惯了 for的人需要注意的。还有一点与 C不同的是， Lite中的字串变数可以直接以 ==来比较，不像 C得呼叫 strcmp（）等函数才能比较两个字串。 Lite的函数定义： Lite 与 C的自定函数方式几乎完全一样，但是有两点要注意的是， Lite仅能够传值，而不能够传址；另外在传回值时，可自由传回任意型态的变数，与 C只能传回固定型态的变数是不同的。以下是 Lite定义函数的固定格式：

funct函数名称（变数型态变数名称 ,变数型态变数名称， ......）

｛

叙述；

｝

下面是两个正确定义函数的例子：

funct addition（ int＄ value1， int＄ value2）

｛

＄ result=＄ value1+＄ value2；

return（＄ value）；

｝

funct merge（ array $values， int$numV- als)

｛＄ count=0;

＄ result=“ ” ；

while（＄ count＜＄ numValues)

｛

＄ result=＄ result＋ $values[$count ];

＄ count=＄ count＋ 1；

｝

return（＄ result )；

｝

Lite的标准模组：

Lite的标准模组就如同 C的标准函数库一样，可以在任何的 Lite程式中被呼叫而使用，由於支援的函数太多，无法在此列举，读者可参阅 /usr/local/Hughes/doc/manual/mod_std.htm的完整说明。

Lite Mini模组：

这是提供与 Mini SQL Database沟通的函式库，是我们常常要使用到的函数，所以在此说明各个函数的语法功能：

语法： int msqlConnect（ char＊ host）

功能：将与 host的 mSQL Server连线，若不设定 host，则表示将与 local端 mSQL Server连线。

范例：

＄ sock=msqlConnect（ “ research.Hughescom.au” ）； if（＄ sock＜ 0）

｛

echo（ “ ERROR : ＄ ERRMSG\n” ）；

｝

语法： msqlConnect（ int sock）

功能：将关闭此 socket的连线。

范例：

msqlClose（ $sock）；

语法： int msqlSelectDB（ int sock， char＊ db ）

功能：告知已连线的 mSQL Server将使用那一个资料库。

范例：

if （ msqlSelectDB（＄ sock， “ my_db” ）＜ 0）

｛

echo（ “ ERROR∶ ＄ ERRMSG\n” ）；

｝

语法： int msqlQuery（ int sock， char＊ query）功能：送出 SQL命令给 mSQL Server。

范例：

if（ msqlQuery（＄ sock， “ select＊ fro- m foo” ）＜ 0）

｛

echo（ “ ERROR∶ ＄ ERRMSG\n” ）；

｝

语法： msqlStoreResult（）

功能：传回之前 msqlQuery所查询的结果。

范例：

＄ res=msqlStoreResult（）；

语法： msqlFreeResult（ int res）

功能：释放上一范例中＄ res所占用的记忆体。

范例：

msqlFreeResult（＄ res）；

语法： msqlFetchRow（ int res）

功能：传回所得到的结果中的每一行资料。

范例：

＄ row=msqlFetchRow（＄ res）；

if （＃＄ row==0）

｛

echo（ “ ERROR∶ ＄ ERRMSG\n” ）；

｝

else

｛

echo（ “ Field 0 is ＄ row[0]\n” ）；

｝

语法： msqlDataSeek（ int res， int location）功能：可以移动＄ res中的 data pointer，若 location为 0将使得 data pointer重新指向第一笔资料结果，若此时再下 msqlFetchRow()将会传回第一行资料。

范例：

msqlDataSeek（＄ res， 0）；

语法： msqlListDBs（ int sock）

功能：传回此 sock连线之 mSQL Server上所有可用的资料库名称。

范例：

＄ dbs=msqlListDBs（ $sock）；

＄ index=0；

while（＄ index＜＃＄ dbs）

｛

printf（ “ Database=%s\n” ，＄ dbs[＄ index]）；

＄ index=＄ index＋ 1；

｝

语法： msqlListTables（ int sock， char＊ db）功能：传回此 database上所有 table的名称。

范例：

＄ tabls=msqlListTables（＄ sock， “ my

_db” ）；

＄ index=0；

while（＄ index＜＃＄ tabls）

｛

printf（ “ Table=%s\n” ，＄ tabls[＄ index]

）；

＄ index=＄ index＋ 1;

｝

语法： msqlInitFieldList（ int sock， char＊ db， char＊ table）

功能：产生一个 result handle，它包含了此 table 中所有栏位的一些细节资料，这个 result handle将是下一个函数将会用到的必要资料。

语法： msqlListField（ int res）

功能：传回 res（为 result handle）中的栏位属性资料，传回的值为一个阵列。

阵列元素存放资料的叙述栏位名称

1 栏位型态

2 栏位长度

3 栏位旗标

范例：

＄ res=msqlInitFieldList（＄ sock， “ myb”

， “ my_table” ）；

＄ field=msqlListField（＄ res）；

while（＃＄ res＞ 0）

｛

echo（ “ Name ＄ field[0]\n” ）；

＄ field=msqlListField（ $res）；

｝

语法： msqlFieldSeek（ int res， int location）

功能：将会移动＄ res（为 result handle）中的 pointer，指向所指定的 location。

语法： int msqlNumRows（ int res）

功能：传回＄ res（为 result handle）的 rows总数。

范例：

msqlQuery（＄ sock， “ select＊ from foo” ）

；

＄ res=msqlStoreResult（）；

printf（ “ There are%d rows in foo\n” ， msq-lNumRows（ $res）；

语法： msqlEncode（ char＊ string）

功能：可将 string中可能导致错误的字元跳过，传回不含错误字元的字串。

范例：

＄ name=“ O'Reilly” ；

＄ newName=msqlEncode（ $name）；

以上大略简介一下 Lite，希望读者能够对它能够有个初步的了解，才能够对於我们接下来要介绍的 W3-mSQL不会太迷惑，其实笔者在此只是简介了 Lite的语言部分而已，实际上它还有其他很棒的功能！诸如编译，函式库等功能都一应俱全，搭配 mSQL发展应用程式既简单又快速喔！

W3-mSQL 2.0 Beta 实本身就是一个 CGI程式，只是这个 CGI程式具有解析 Lite语言的能力，能够依照 Lite语言的程式叙述来做事，并且制作出最後完全的 HTML输出。那究竟我们该如何才能使用它呢？其实很简单，现在先制作的第一个加入了 Lite叙述的 Homepage吧！我们替这个 HTM-L档案取名成 Hello.htm，并存放在 /usr/local /Hughes/www/目录中，以下为这个档案的内容：

＜ HTML＞

＜ HEAD＞

＜ TITLE＞ Hello World from W3mSQL＜ /TITLE＞

＜ /HEAD＞

＜ BODY＞

＜ CENTER＞

＜ H1＞ Introduction to W3mSQL＜/H1＞

＜ P＞

＜！ echo（ “ Hello World\n” ）；＞

＜ /CENTER＞

＜ /BODY＞

＜ /HTML＞

其中只有 echo（ “ Hello World\n” ）；为 Lite叙述，而我们 Homepage中的 Lite叙述都必须以＜！与＞括起来，才会被 W3-mSQL当成是 Lite 程式叙述来执行，否则只会当成是一般 HTML输出，而不会当成程式来执行。读者可以试试用浏览器来开启 http： //your.host/cgi-bin/w3-msql/Hello.htm即可看到结果如图十，现在我们就来一步步讲解 w3-msql是如何运作的，首先它接收到 /Hell-o.htm的参数後，会先去找寻 Homepage Root（一般为 htdocs）目录下是否有 Hello.htm这个档案，若无此档案则至 /usr/local/Hughes/www目录下寻找 Hello.htm，找到後，一步步解析其档案内容，非 Lite叙述则直接输出，遇到＜！才开始执行 Lite叙述，遇到＞才结束执行 Lite叙述。聪明的读者可能会问，为什麽要搜寻这两个目录呢？因为若是我们不想将原始程式码那麽轻易给人家知道，就可以把写好的 Homepage放置在 /usr/local/Hughes/w-ww中，若是放在 Homepage Root中，别人很容易就可以拿到我们辛辛苦苦写的程式罗！

在一般 CGI程式中，最重要的莫过於 Form的参数传递了，那麽 W3-mSQL可以传递 Form的资料吗？答案是肯定的，而且非常简单，举例来说，若有一个 Form如下：

＜ FORM ACTION=/cgi-bin/w3-msql/my_stu-ff/test.html METHOD=POST＞

＜ INPUT NAME=username SIZE=20＞

＜ INPUT NAME=password SIZE=20 TYPE=PASSWORD＞

＜ SELECT NAME=user_type＞

＜ OPTION VALUE=“ casual” ＞ Casual User

＜ OPTION VALUE=“ staff” ＞ Staff Account

＜ OPTION VALUE=“ guest” ＞ Temporary

Guest Account

＜ /SELECT＞

则在 test.html中，我们可以直接使用＄ usern-ame，＄ password，＄ user_type来代表所传进来的参数，比起 CGI程式可要方便多啦！讲到这里，可能有许多读者们早已经忍不住想要试试了吧！先别急，让笔者再注明一次，之前笔者介绍的 Lite标准模组与 Lite Mini模组都可以直接应用在我们的 Homepage中，详细的范例可以参考 /usr/local/H-ughes/www/bookmarks/＊ .htm，这是 Mini SQL 的 bookmark资料库范例，读者们可以仔细研究後再加以应用喔！

MiniSQL的一些管理工具程式 (S-tandard Pr-ograms and Utilitie-s) 这些工具程式都位於 /usr/local/Hughes/bin目录中，以下就一一介绍其功能：

程式名称： msql

功能：可与 mSQL Server连线，直接存取资料库。

程式名称： relshow

功能：可得知 mSQL Server资料库的架构。

程式名称： msqladmin

功能：此程式可管理资料库，做新增、删除资料库等动作，还可以关闭 mSQL Server。功能依照 Command不同来决定。

Command选项：

create db_name 新增一个名叫 db_name的资料库。

drop db_name 删除名叫 db_name的资料库。

shutdown 关闭 mSQL Server。

reload 重新读取 ACL设定档案，采用新的设定值。

version 显示系统版本与相关资讯。

stats 显示系统的统计资料。

程式名称： msqldump

功能：可产生一个包含了 SQL命令的 ASCII档案，这个档案可以重建资料库架构。

程式名称： msqlexport

功能：将资料库某 table中的所有资料一笔笔显示出来。

程式名称： msqlimport

功能：可从一个文字档中的资料一笔笔转换到资料库中。

结语

笔者这次介绍 mSQL Server是站在对资料库已有初步了解的使用者角度来说明，对於一般刚入门的读者看起来则会吃力许多，顾此失彼，还望见谅！若您对 mSQL仍有问题，也欢迎您多多来信指教。