打印

txtSQL安装手册中文版

cots

主管

Rank: 4

发短消息
加为好友
当前离线

1^# 大中小发表于 2007-4-29 12:35 只看该作者

txtSQL安装手册中文版

txtsql的最大优点之一是文档很详细，可惜，我在网上找了半天也找不到中文版的文档，所以只好自己动手，利人利已吧，不过自己的E文水平自己是很清楚的，希望大家看了不会笑掉大牙才好，还希望大家多多指教。) I3 m9 D; E( G6 R& }
欢迎使用txtSQL 2.2快速安装手册。, F+ l9 M' h7 M
这页将指引你如何开始安装txtSQL。如果你在看完这页时仍然需要某种帮助，请到我的讨论板上讨论！
1-解压缩下载包9 ^0 E5 }, S" v1 {, b% s
2-配置类文件# w3 ^; b  A# I- S. ^
2.1-目录结构4 o& T; [/ c- J8 A. X+ R; X$ E9 y
3-包含类文件
, D' V( A3 k. S5 v  3.1-类实例
- i! O4 s  q1 j  3.2-连接到txtSQL2 C, c9 d* Z  c# u) l9 T4 O! ]
  3.3- 更改密码
) X0 A8 W2 f% l2 B9 Y- k( w  3.4-选择一个数据库, ]( Q7 E; u. r
4-执行SQL指令
: H. `- P# r# R/ I! Y# _$ } 4.1-指令的列表
$ ^, x7 C) a- \, D6 S5 e 4.2-显示结果
4 X- z* C& Z& [; E2 |5-从断开txtSQL连接
! z6 W6 y8 O: b6-差错处理
0 u# e1 [  R1 j% e6 [; [7-已发布的txtSQL函数$ n8 I6 s, x( c9 `6 N4 n
' i+ A  a; ~+ U
' {4 _2 T: T$ P3 `7 {
1、解压缩下载包; X: c5 F  J# S" C, P1 w- c
当你打开.zip文件时，你将注意到有两个文件： txtSQL.class.php和txtSQL.core.php。提取两个文件到相同的目录。新建一个任意名字的新目录；通常，它名为‘data’。这将是包含数据库的目录。它能可以放在服务器上的任何地方，但是它通常位于以上两个文件的同一目录下。确保这个目录权限是0755或者更高。现在返回到.zip文件找到'txtsql.MYI'提取它到我们刚刚建立的数据库目录。（译者注：其实不用这么麻烦，.zip文件已经组织好了，全部解压到服务器上的任意目录，并设置权限就行了）1 q4 j7 ?# J; w% z. v5 k( T
2、配置类文件
/ h5 U- g# k( t4 p使用txtSQL的第一步，配置类文件，这样它才能被包含到可能要求它的php文件中。首先，你必须在文本编辑器中打开文件‘txtSQL.class.php’; 打开文件时将注意到一个版权声明，其后是一些其它素材。随后有这样一行(缺省是第30行)：
30. include_once('./txtSQL.core.php');3 |: v' }, a5 c0 M6 |) B( ~2 R& y% R
这一行代码使它包括txtSQL的的核心函数和类。方便php找到核心文件，你必须编辑单引号内的内容，让它指向‘txtSQL.core.php’文件。（译者注：这个基本上也不用设置，源文件已经配置好了！只有当你的文件不在同一目录时，才需要这么做）( C4 _' @( J4 H4 i  w* U; c; a, e* ^
2.1、目录结构
一个有效的数据库目录结构应该是这样的：% v# S- s6 o8 n7 l
+ datafolder (所有数据库的保存目录，比如上面新建的'data' )
         + database_name: d: R+ g4 r% k8 `. B7 G
               + table.FRM (列定义)- s5 ?, E/ j- h# e1 U" A' T
               + table.MYD (行数据)! h2 D" H0 N. n& P- j
         + txtsql4 Y: B' q& H2 i9 X' I, I
         + txtsql.MYI (包含在压缩包)7 j  t  S# u) a/ S; c/ J
基本上，一个数据库是主要的数据库目录下的一子目录。
同时在数据库目录内部是txtsql数据库，压缩包中的'txtsql.MYI'I。2 d( `* w" w7 x
在所有的数据库内部，一个数据表由两个文件组成； table.FRM，和table.MYD。.FRM是列定义，另一个是数据行。! t- N4 q$ G( C: a1 \1 G9 t7 S9 m
3、包含类文件1 M8 w% I0 @: Z3 b9 ?, U% y( A
现在我们已经配置完txtSQL2.2，我们能开始使用它。首先使用文本编辑器创造一个空白的php文件。保存为‘example.php’。
为了简单的说明，假设你把它保存在和'txtSQL.class.php'同样的目录下。
现在我们必须包括php类，在'example.php’中输入：
<?php" P+ O7 h! c$ y  x; q
include('./txtSQL.class.php');: @6 o+ n: B7 {( `+ ]7 U: p! c
?>
3.1类实例9 G$ T5 C. D2 f5 T
在面向对象编程( OOP)中，当创建类时，一种特殊变量类型--个对象是自动地创造。
我们需要创造指向txtSQL类的一个对象，那么把这些添加到文件：
<?php
include('./txtSQL.class.php');7 C( g" M' D- D, b
$sql = new txtSQL('./data');
  ?>
  在单引号中的文字，是包含所有数据库的数据目录的路径。这个目录下必须包含一个‘txtsql’(大小写敏感 )的目录，目录下应该有一个'txtsql.MYI'的文件。这个文件包含操作数据库所有用户与和密码。/ ?( K3 L- p+ x3 B
  这个目录与文件已经在txtSQL压缩包中。一旦路径是正确的，你可以继续向前到下一段。) I3 {8 b$ I) y& ~/ p
  3.2连接数据库3 ^2 F8 @2 e  k+ `" s
  现在我们可以用正确的用户名和密码来连接数据库了。8 a* W6 w# G+ t' \) u5 V! y
  默认的用户名是‘root'，默认的密码是空。（强烈建议在下面的步骤中修改)) s; R0 q2 \8 b0 m1 R7 |- F! I
  用下面的代码来连接数据库：
  <?php
include('./txtSQL.class.php');3 r" `" G& q/ I) J! [
$sql = new txtSQL('./data');4 N, a$ r! ?$ f3 i9 h
$sql->connect($username, $password); // 默认时是 $sql->connect('root', '');. b6 M1 n. k/ d# u
?>
txtSQl这时会认可你是它的用户，准许你访问数据库和表。
注意：参考手册中有可用的命令清单。0 m% I5 b) |  H6 ]/ K# z& `* T9 {
3.3、更改密码) E3 y+ l4 W( `
如果你想更改管理员密码（root)，可以用grant_permissions() 函数，grant_permissions() 函数这样调用：
<?php9 n& j/ p' M! _7 X$ A$ A1 B1 h
  include('./txtSQL.class.php');9 O* `0 E% Y' x- W7 C( t
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');0 O+ M# y( g( m; w. i" _/ i3 A$ }
$sql->grant_permissions($action, $user, $pass [, $newpass]);
?>: C% m! p2 J# q( M# a+ q
参数 $action（动作）可以是 add（添加）, drop（删除）, or edit（编辑）. $newpass（新密码）只有在你编辑（edit)用户时才可用。 $user（用户）是用你要操作的用户名,  $pass是它的密码。7 t0 {  E5 m1 E9 r/ L% F2 z8 [2 H
例如, 如果你想改变用户'root'的密码为 'bar' (假设它还是空的), 我们可以这么做：
<?php
include('./txtSQL.class.php');" p1 ?" y# e$ k1 z2 u
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');
$sql->grant_permissions('edit', 'root', '', 'bar');
?>7 z* N% \* L; W/ r  ?1 T( @
或者2 `! |9 X2 `8 p$ T2 _9 t
新建一个用户 'foo' 密码为'bar'
<?php
include('./txtSQL.class.php');1 ]. N5 i  A3 c- }
$sql = new txtSQL('./data');4 d! \) v0 W3 y+ W& s
$sql->connect($username, $password); // default is $sql->connect('root', '');) I  o0 V3 w! u! f  Z7 c
$sql->grant_permissions('add', 'foo', 'bar');
?>+ M0 a0 c& [, X. h* G* H
或者# c1 n2 @( B% N4 e3 f% e
删除一个用户'foo' 密码为 'bar'
<?php* Q4 _0 n2 R4 G3 [
include('./txtSQL.class.php');
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');
$sql->grant_permissions('drop', 'foo', 'bar');; h5 f/ e6 w: C8 h/ J
?>
注意：你不用删除用户‘root'，如果没有正确的密码你也不能访问任何数据。
3.4、选择数据库
像mySQL一样, 在操作一个数据表之前,你必须先说明它在哪一个数据库. 这个步骤不是必须的，因为你可以在操作时指定使用哪一个数据库." q3 w4 \+ {( K( D/ a& X
我们使用下面的语句来选择一个数据库： 1 r- {, z6 z7 y& u, ^5 K
<?php
include('./txtSQL.class.php');, B+ I/ F$ q- @; m& i0 H* G5 ^
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');8 R- S9 S3 ~7 g
$sql->selectdb('test'); //选择了数据库 'test'( a" x/ q/ T+ k
4、执行指令
6 Y/ y. s; X& W$ ^( z3 {6 B4 y5 |9 e+ q通常我们只要使用$sql对象的各种方法下执行指令。
例如：
<?php
include('./txtSQL.class.php');' B- l9 Y( m2 A1 U
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');
$sql->selectdb('test'); // 选择了数据库 'test' $results = $sql->select(array(
         'db' => 'test', //这行不是必须的，因为我们已经选定了数据库$ r  f3 b3 Q. f# ?" u) g7 m" y
         'table' => 'test',4 G6 R* N6 M8 v* m, P$ c/ Y2 }
         'where' => array('id = 10', 'and', 'name =~ John Smith'),
         'limit' => array(0, 100)6 C3 Z: ?8 h& ], r0 t  {! X
         ));
?>3 L* q' N, N" x7 `1 J8 L
4.1、指令列表$ F" P4 i- N$ I. d6 o
txtSQL2.2支持的指令如下：: m8 F- E5 b2 A: w* F" a
4.1- List of commands4 a( O9 G# K& V8 m2 n* a5 c' L
showdbs()
createdb()
dropdb()
renamedb() , z) g# t  E9 `' y: i9 o
select()
insert()
update()
delete() $ [# A$ k; i) q8 m3 Y% k) A5 s
showtables() ) W" H6 w9 n' @
createtable()
droptable() " h/ k1 Y, i: U- ?1 g, i# ^( b0 u% z3 }
altertable() : L: N/ b" d% Q) ?+ h
describe()
在执行指令之前，你必须连接数据库，不然会产生错误。手册中会用详细的指令说明和实例（随后翻译）。
4.2、显示结果7 s; Q  B  a+ c  M8 A$ j( \
$results变量现在包含了表‘test'中选中行的信息。1 k5 ~% ?, O5 i1 t2 }/ O
你可以用一个循环来实现显示$results中的所有结果。; G: ~9 R0 ]3 v3 |; \
<?php
include('./txtSQL.class.php');2 Y% @/ N6 s1 s8 x3 u, P' L% V" ~
$sql = new txtSQL('./data');& [, S0 [: ]& p0 y
$sql->connect($username, $password); // default is $sql->connect('root', '');
$sql->selectdb('test'); // database 'test' is now selected0 u/ L4 J, \' _8 K) o# q1 S# ]( h7 D
$results=+ v! j5 [* _3 h7 i% t, p
$sql->execute('select',& ~0 K9 V2 m1 o. i& O/ \" Y- Z9 o* K
         array('select' => array('id', 'name'),
               'db'    => 'test',
               'table'  => 'test',
               'where'  => array('id = 10', 'and', 'name =~ John Smith'),2 ^" j  m# {- \  F
               'limit'  => array(0, 100))));
foreach ( $results as $key => $row )
{
print "ID: $row[id], NAME: $row[name]<BR>\n";* d$ n0 k4 |1 v
}
?>8 K7 T+ A1 I8 A4 t6 x3 V. k; [7 v. q
5-断开txtSQL8 q; t0 f7 x7 T3 A
用完之后断开数据库是一个好习惯。断开用 disconnect()函数。
<?php
include('./txtSQL.class.php');; L, [/ K' j& e. k: a
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');- L4 h3 k6 s" M( S$ w4 g
$sql->selectdb('test'); // database 'test' is now selected6 F! h; Q5 f+ U
$results=
$sql->execute('select',& I/ C: c7 [+ l( N
         array('select' => array('id', 'name'),2 Z* C: q5 \' Q0 u5 e1 f
               'db'    => 'test',
               'table'  => 'test',3 A4 `1 H0 D( g
               'where'  => array('id = 10', 'and', 'name =~ John Smith'),/ T2 ~4 ], u1 j# O8 j% M
               'limit'  => array(0, 100))));
foreach ( $results as $key => $row )' @: G: M7 c4 C8 r- c
{/ p5 e; c( `# \2 g; }
   print "ID: $row[id], NAME: $row[name]<BR>\n";
}
$sql->disconnect();  u: ]% B/ N8 X+ z
?>" V4 }( d' C4 j% V! Z  r
6-错误处理% ?" W4 ]0 o; ?8 b! z8 Q& z
txtSQL 包含错误处理能力。主要用以下的函数： ! A+ j9 {' G, c  @5 ?; T
strict() $ q0 V7 X) c8 t: c( |4 t
get_last_error()
last_error() 6 _- M. C. I1 n) |  D( b
errordump()
7-已发布的txtSQL函数（随后附上)

转摘（邵东好blog)