txtSQL安装手册中文版(页 1) - 编程语言学习 - 星星电脑技术论坛电脑技术|QQ|DIY|网络|程序设计|l软件下载|病毒安全|电影|音乐|笑话|美女图片|广告

cots 发表于 2007-4-29 12:35

txtSQL安装手册中文版

[color=#3366cc]txtsql的最大优点之一是文档很详细，可惜，我在网上找了半天也找不到中文版的文档，所以只好自己动手，利人利已吧，不过自己的E文水平自己是很清楚的，希望大家看了不会笑掉大牙才好，还希望大家多多指教。[/color]
欢迎使用txtSQL 2.2快速安装手册。
这页将指引你如何开始安装txtSQL。如果你在看完这页时仍然需要某种帮助，请到我的讨论板上讨论！/@:I)x1N1f&n!\
[b]1-解压缩下载包
2-配置类文件P ^y$l'OK1S1~
2.1-目录结构#B3O;}ZhsDf
3-包含类文件#y cl@#\7Q
  3.1-类实例p*^8w` ~!j$|1l
  3.2-连接到txtSQL
  3.3- 更改密码%W/kbw(S)T`
  3.4-选择一个数据库
4-执行SQL指令1B"P u]@ Ge
4.1-指令的列表 kNP!N*e }m:RCFv7p}
4.2-显示结果q]|4XWG{l^
5-从断开txtSQL连接M*{4E%v;sdy)s*\
6-差错处理
7-已发布的txtSQL函数
[/b]y.k,E l/t/W3y|w

[b]1、解压缩下载包[/b]!~9u,? e8c1E0tS dU
当你打开.zip文件时，你将注意到有两个文件： txtSQL.class.php和txtSQL.core.php。提取两个文件到相同的目录。新建一个任意名字的新目录；通常，它名为‘data’。这将是包含数据库的目录。它能可以放在服务器上的任何地方，但是它通常位于以上两个文件的同一目录下。确保这个目录权限是0755或者更高。现在返回到.zip文件找到'txtsql.MYI'提取它到我们刚刚建立的数据库目录。（译者注：其实不用这么麻烦，.zip文件已经组织好了，全部解压到服务器上的任意目录，并设置权限就行了）
[b]2、配置类文件@ wgM|(G;xJ
[/b]使用txtSQL的第一步，配置类文件，这样它才能被包含到可能要求它的php文件中。首先，你必须在文本编辑器中打开文件‘txtSQL.class.php’; 打开文件时将注意到一个版权声明，其后是一些其它素材。随后有这样一行(缺省是第30行)：w,F]+Fi#C0tv|
30. include_once('./txtSQL.core.php');
这一行代码使它包括txtSQL的的核心函数和类。方便php找到核心文件，你必须编辑单引号内的内容，让它指向‘txtSQL.core.php’文件。（译者注：这个基本上也不用设置，源文件已经配置好了！只有当你的文件不在同一目录时，才需要这么做）+q.J'cO5|Y%qb.o
2.1、目录结构
一个有效的数据库目录结构应该是这样的：
+ datafolder (所有数据库的保存目录，比如上面新建的'data' )(T0c+x+tm8t
         + database_namez2v ]4ups
               + table.FRM (列定义)
               + table.MYD (行数据)
         + txtsql:y`-qH8^
         + txtsql.MYI (包含在压缩包)(O-L`I9y6Zcq
基本上，一个数据库是主要的数据库目录下的一子目录。
同时在数据库目录内部是txtsql数据库，压缩包中的'txtsql.MYI'I。
在所有的数据库内部，一个数据表由两个文件组成； table.FRM，和table.MYD。.FRM是列定义，另一个是数据行。
[b]3、包含类文件
[/b]现在我们已经配置完txtSQL2.2，我们能开始使用它。首先使用文本编辑器创造一个空白的php文件。保存为‘example.php’。
为了简单的说明，假设你把它保存在和'txtSQL.class.php'同样的目录下。
现在我们必须包括php类，在'example.php’中输入：
<?php9K;@H,\#KN)Z
include('./txtSQL.class.php');y9F ^;k2tm
?>P ~3q#@v}
[b] 3.1类实例
[/b] 在面向对象编程( OOP)中，当创建类时，一种特殊变量类型--个对象是自动地创造。
我们需要创造指向txtSQL类的一个对象，那么把这些添加到文件：
<?php
include('./txtSQL.class.php');};rs7i|k3ff&L}
$sql = new txtSQL('./data');
  ?>
  在单引号中的文字，是包含所有数据库的数据目录的路径。这个目录下必须包含一个‘txtsql’(大小写敏感 )的目录，目录下应该有一个'txtsql.MYI'的文件。这个文件包含操作数据库所有用户与和密码。
  这个目录与文件已经在txtSQL压缩包中。一旦路径是正确的，你可以继续向前到下一段。:A LQ:V-m B
  [b]3.2连接数据库
[/b]  现在我们可以用正确的用户名和密码来连接数据库了。0@8g|?K!k
  默认的用户名是‘root'，默认的密码是空。（强烈建议在下面的步骤中修改)#`Cn sz-J
  用下面的代码来连接数据库：0GknJ o-xa)P
  <?php
include('./txtSQL.class.php');
$sql = new txtSQL('./data');%}6f;B$a7rQ^{
$sql->connect($username, $password); // 默认时是 $sql->connect('root', '');rm9o5uK(Z6Je
?>UW1o)nB HQ? I @
txtSQl这时会认可你是它的用户，准许你访问数据库和表。 M FFsU K\7_
注意：参考手册中有可用的命令清单。~#s1gU(? M1?
[b]3.3、更改密码[/b]3`$A0iu#N]&h
如果你想更改管理员密码（root)，可以用grant_permissions() 函数，grant_permissions() 函数这样调用：r;|(Xo)w.b.@/ih"`
<?php ?!sDyN+s2m
  include('./txtSQL.class.php');3[z;}L l
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');:x2P8uz]"F
$sql->grant_permissions($action, $user, $pass [, $newpass]);
?>
参数 $action（动作）可以是 add（添加）, drop（删除）, or edit（编辑）. $newpass（新密码）只有在你编辑（edit)用户时才可用。 $user（用户）是用你要操作的用户名,  $pass是它的密码。z2b$Qo p,O1A9i8[`*q
例如, 如果你想改变用户'root'的密码为 'bar' (假设它还是空的), 我们可以这么做：
<?php
include('./txtSQL.class.php');\5Jza:\@ wO
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');?WDA{,X4{PAw
$sql->grant_permissions('edit', 'root', '', 'bar');
?>XHYo4s ]5q4xk
或者
新建一个用户 'foo' 密码为'bar'
<?phpP-Lz6z5^g(\3w)S|
include('./txtSQL.class.php');
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');
$sql->grant_permissions('add', 'foo', 'bar');
?>xhDi(u"}t&Y
或者%X(x-G.Y5tX
删除一个用户'foo' 密码为 'bar' zcZY+Q4xYZ
<?php
include('./txtSQL.class.php');
$sql = new txtSQL('./data');HXc(Sb3Bz'y0USk2@
$sql->connect($username, $password); // default is $sql->connect('root', '');*z#s/T-{#z
$sql->grant_permissions('drop', 'foo', 'bar');
?>
注意：你不用删除用户‘root'，如果没有正确的密码你也不能访问任何数据。
[b]3.4、选择数据库[/b]S{,I]BC
像mySQL一样, 在操作一个数据表之前,你必须先说明它在哪一个数据库. 这个步骤不是必须的，因为你可以在操作时指定使用哪一个数据库.
我们使用下面的语句来选择一个数据库：
<?phpmJJ aR)RI
include('./txtSQL.class.php');
$sql = new txtSQL('./data');k/|7e@T3E1i`n5n:h
$sql->connect($username, $password); // default is $sql->connect('root', '');
$sql->selectdb('test'); //选择了数据库 'test'
[b]4、执行指令OT \'n^3X2?f
[/b]通常我们只要使用$sql对象的各种方法下执行指令。
例如：ZD9G Jn Ju(`
<?php nUh:H"IT3bFBB
include('./txtSQL.class.php');
$sql = new txtSQL('./data');s$_aGvB
$sql->connect($username, $password); // default is $sql->connect('root', '');[$X*gZ-Rq:{D
$sql->selectdb('test'); // 选择了数据库 'test' $results = $sql->select(array(
         'db' => 'test', //这行不是必须的，因为我们已经选定了数据库yK9B!qk`wTZ4I
         'table' => 'test',5t?;a"\3g7|
         'where' => array('id = 10', 'and', 'name =~ John Smith'),uv$V'w Vi
         'limit' => array(0, 100)Wmy KY$U.Mv2YT
         ));
?>P4mlP-t6myx(l(C8x ^
[b] 4.1、指令列表.hy b_ a#z}
[/b] txtSQL2.2支持的指令如下："Vy L"TN+qmf
4.1- List of commands
showdbs() y%?.jJoQ'O;u mj2dm+v
createdb()
dropdb()
renamedb() 6W9fr0V@eQD
select() fH j)} mj@Xo
insert()
update() "qvX Td+E!y!C
delete()
showtables() /ci!AP"J)N6V0~)T/Po
createtable() +bL'DU wAg"w
droptable() -lb@C"\y
altertable()
describe() G1c&A;^.U
在执行指令之前，你必须连接数据库，不然会产生错误。手册中会用详细的指令说明和实例（随后翻译）。
[b] 4.2、显示结果4s!X C-v J\5A
[/b] $results变量现在包含了表‘test'中选中行的信息。v,[&C7b H`0b7W%S
你可以用一个循环来实现显示$results中的所有结果。
<?phptF?IU.Br
include('./txtSQL.class.php');2a1}v5r Tr(cF
$sql = new txtSQL('./data');_X.@i ^H
$sql->connect($username, $password); // default is $sql->connect('root', '');rq2T2OY%Kj3|K.U
$sql->selectdb('test'); // database 'test' is now selectedYn`I1gbz k
$results=jW,@-O R b.j
$sql->execute('select',j `hH[Bz{
         array('select' => array('id', 'name'),&O;L vVbUpjN T
               'db'    => 'test',
               'table'  => 'test',Y5s4H%Fh PY1?Q)M
               'where'  => array('id = 10', 'and', 'name =~ John Smith'),^fis;W9@p
               'limit'  => array(0, 100))));
foreach ( $results as $key => $row )D0c@~c:hYrP
{
print "ID: $row[id], NAME: $row[name]<BR>\n";
}spv0g~C:suw
?>
[b]5-断开txtSQL1y#LT3kE9i~k
[/b]用完之后断开数据库是一个好习惯。断开用 disconnect()函数。 ~^R!_jgq7I
<?phpbzS~!N QK*D
include('./txtSQL.class.php');
$sql = new txtSQL('./data');
$sql->connect($username, $password); // default is $sql->connect('root', '');z&r`)[\t/f^ P
$sql->selectdb('test'); // database 'test' is now selected
$results=
$sql->execute('select',M,q#iv5C {$x,~(g
         array('select' => array('id', 'name'),O!Ur:hz F [D
               'db'    => 'test',e e8H SkTN6E
               'table'  => 'test',
               'where'  => array('id = 10', 'and', 'name =~ John Smith'),UQEf+Oh.w7[p
               'limit'  => array(0, 100))));/wa kLv(}S)?+C
foreach ( $results as $key => $row )a8Bn x3m4D+z
{YvW7_ E-h6OJ{
   print "ID: $row[id], NAME: $row[name]<BR>\n";L#CS7}I7}1F m
}
$sql->disconnect();
?>:tJ'O4i-}/S
[b]6-错误处理[/b]
txtSQL 包含错误处理能力。主要用以下的函数：
strict() _4S!{ln6}ra,i
get_last_error()
last_error()
errordump()
[b]7-已发布的txtSQL函数（随后附上)[/b]%K-s"X8u v"o
[color=#0000ff][/color]
[color=#0000ff]转摘（邵东好blog)[/color]

janice 发表于 2007-7-8 18:01

謝謝分享，　ding !

深度2007 发表于 2007-10-8 11:36