phplib基本手册Word格式.docx
《phplib基本手册Word格式.docx》由会员分享，可在线阅读，更多相关《phplib基本手册Word格式.docx（17页珍藏版）》请在冰豆网上搜索。
然后根据笔者经验，觉得只要很好掌握其中的基本类和方法后，平时的工作几乎都不需要那些额外的高级类就可以完成了。
1.将数据库驱动和对数据库操作完全分离，这样的好处是对数据库的操作你需要的知识仅仅是SQL语言而不需要去估计各个不同数据库间的函数不同，如果需要将程序移植的话，那么phplib的优势非常明显。
需要修改的仅仅是数据库驱动文件，而程序行几乎都不需要修改任何一行。
如果是采用具体数据库函数操作的程序（例如用MySQL函数编写），那么移植起来几乎是等于重新编写。
区别一看就知道了。
2.支持Session，这个功能可以创建一个受保护的页面。
它可以广泛的应用到需要进行登陆或者依靠帐号和权限来判别的程序。
例如论坛、虚拟社区、新闻发布、用户管理、电子商务等。
而且这个和纯粹的cookie不同，采用了base_64的编码和解码。
因此一般并不容易破译。
为了加强安全性，用户可以自己编写自己的编码方式取代它原来的编码方式。
同时phplib还将每一个会话都保存到数据库中，因此可以通过查询数据库值得有多少用户在线上。
3.权限许可（Perm），这个功能可以定义一系列具有不同级别和权限的用户。
不需要编程人员额外地自己编写相应功能的代码就可以实现了分级管理和限制。
同时可以利用phplib中page/admin目录中的管理程序创建用户和修改相关信息。
编程人员可以修改这些程序来服务自己的系统，节省了大量时间。
4.模板templete，和FastTemplete类似的是，phplib也有自己的模板功能类和文件。
让用户可以方便的创建和修改html模板，并且将php代码和html代码分离。
便于让程序员和美工良好的合作。
phplib的模板采用了定义标记和语法分析、模式匹配等技术，从而实现了和FastTemplete类似的功能。
编程人员可以根据实际的需要对这个功能代码进行修改以满足自己需求。
5.购物车Cart，这个是个比较简易的购物车，各种物品和项目可以存放到车中，也可以被取出来，通过一些改造后也可以将这个功能做成电子商务中流行的购物系统的。
6.Html部件，在phplib中还有一些称为"
HTMLWidgets"
的东西，可以方便地生成窗口/表格等。
具体可以参考phplib手册。
这里不再赘述。
四.phplib基本安装和使用
要想使用phplib强大的功能，有几种途径可以达到目的。
1.采用phplib建议的安装方式，说安装，其实就是把phplib的类预先让解析器加载到内存，这样使用的时候就不需要做任何设置，这样的好处显而易见。
不过缺点也是很多的，如果程序按照这个方式直接引用phplib的函数的话，对于一些采用虚拟主机的用户来说，如果ISP的服务器没有安装phplib的话，就不可以直接使用phplib了。
所以这个方式的前提是：
你的ISP支持phplib或者你有权限控制web服务器，对于一般用户在自己机器上调试的话，这个方式比较好。
详细做法这里不再赘述，只简单说个过程而已：
a.下载phplib最新包，并解压好。
b.将里面的php目录的内容放到一个安全的地方，例如/usr/local/phplib下
c.将这个目录的路径名添加到php3.ini/php.ini的include关键字段后
include.:
/usr/local/phplib
然后在找到auto_prepend_file关键字改成：
auto_prepend_file=prepend.php3
重新启动一次web服务器，用phpinfo（）函数检查包含路径和自动预加载参数，如果显示的值和刚才设定的一样的话就证明成功了。
更加详细的安装/设定可以参考phplib的文档。
2.包含的方式。
这个方式就是比较麻烦，但是好处就是对于使用虚拟主机的用户来说，可以不需要ISP支持phplib就能享受phplib的功能。
基本方法很简单，可以在使用到phplib功能的程序最顶部加入相应的包含文件。
不过要注意文件之间的相互依赖关系，下面是一个简单例子，它可以调用到基本的MySQL数据库驱动功能和Session功能：
$LIBDIR="
/usr/local/phplib"
;
require（$LIBDIR."
db_mysql.inc"
）;
ct_sql.inc"
session.inc"
local.inc"
page.inc"
五.如何使用phplib数据库驱动
（一）
第一部份：
数据库连接/查询
a.四步曲:
【ChinaByte教程】1.要根据库中的DB_Sql来编写一个类，这个只需要在你的顶层包含文件中定义好就行了，同一个程序使用时不需要重定义，例子是：
classslashDBextendsDB_Sql
{
var$classname="
slashDB"
/****Remembertochangethebelowitemstomatchyourdb*****/
var$Host="
localhost"
var$Database="
abc"
var$User="
var$Password="
functionhalt（$msg）{
printf（"
数据库出现错误!
:
%s\n"
$msg）;
MySQL错误!
%s（%s）\n"
$this->
Errno,$this->
Error）;
请联系WebMaster并报告此出错信息得详细内容。
\n"
die（"
Session挂起。
"
}
}
其中slashDB的名字是任意的，根据编程者的喜好设定，不过都建议用extends语句生成的类的名字最好都有DB两个字。
例如userDB，slashDB。
并且$classname要和classslashDBextendsDB_Sql中slashDB一样！
否则类定义出错。
其他需要修改的仅仅是类的名字，$classname，$Host，$Database，$User，$Password等需要修改。
函数halt是错误提示。
你可以自定义到一个页面。
2.使用编写好的类的时候，用new关键字$abc=newslashDB;
其中$abc是个变量名，这代表你要使用slashDB类的功能。
3.查询数据库
一般有2个方法，短的查询直接将语句写到函数，长的就先用一个变量分别储存再查询。
a.短语句：
$abc->
query（"
SELECT*FROMuserWHEREusername='
kk'
ANDpasswd='
"
注意的是这里是一个调用slash类中的方法query，并且数据库查询语句不能漏了"
，否则出错。
b.长语句
$q="
SELECTusername,passwd,email,nation,url,edulev"
$q.="
seclevFROMuserWHEREusername='
$username'
ANDaid='
$aid'
ORDERBYIDDESC"
query（$q）;
//这里才执行查询
采用了短语句合成长语句的方法。
其中需要注意的是第一个$q是起始的语句，不能跟“.”号!
接着同名的$q就是需要和第一个$q合成的变量，其实是同一个变量但是分别赋一个长语句的不同部分。
因为为了避免互相覆盖就用“.”号!
!
切记切记!
另外查询语句中该有空格的必须有空格，即使该行没有，下一行也必须有。
例如$q.="
句中最后有一个空格如果他没有，而接着的行开头没有的话，数据库查询会出错的。
4.取得结果
next_record（）;
这个是一个没有返回值的语句，他只会让Record[];
这个方法产生相应的查询结果。
如果没有这句话就不会产生相应的结果。
next_record（）是将当前指针向前移动并更新Record、Error、Row、Errno的函数。
因此不运行他一定不能够产生你需要的结果。
$temail=$abc->
Record["
email"
];
$turl=$abc->
url"
这几句就是将查询后的结果赋值给指定的变量。
注意：
一般如果返回的row超过一行，你就要用习惯方法：
while（$abc->
next_record（））{php代码}来进行处理了。
这个方法就是便历了所有查询到的结果。
六.如何使用phplib数据库驱动
（二）
第二部份：
数据库插入/删除
b.插入/两步曲：
【ChinaByte教程】1.创建一个调用类的变量
$add=newslashDB;
2.进行数据库查询操作（实际上无论是SELECT还是INSERT等语句都是调用query方法和MySQL交互的）
$add->
INSERTINTOvarsVALUES（'
a'
'
b'
c'
）"
注意这里其实INSERT语句有很多写法，其中最多用的就是以下几种：
（1）.直接赋值：
INSERTINTO表名字VALUES（值列表，用'
'
号包含，用,号分隔）;
例子：
（2）.指定插入字段：
INSERTINTO表名字（指定字段名字列表）VALUES（对应字段值）;
INSERTINTOvars（name,mail）VALUES（'
kk@k'
两者差别在于第一种必须给所有字段赋值，无论是空还是非空都要赋值，如果数据表有很多字段而你开始只需要插入很少几个字段，那么就会浪费很多人力了。
第一种适合于字段少的情况。
第二种就是为了处理第一种的缺陷的。
但是不适合于数据表字段少的情况。
删除/两步曲：
1.创建一个调用类的变量
$del=newslashDB;
2.查询操作
$del->
DELETEFROMuserWHEREusername='
一般这是删除某一条特定记录。
如果要删除全部内容更加容易。
只需要DELETEFROM数据库表名字可以了。
c.数据库内容更新
更新/两步曲：
1.创建一个调用类的变量
$update=newslashDB;
2.查询操作
UPDATEuserSETusername='
passwd='
$pwd'
email='
$mail'
WHEREID='
$id'
ANDDATE='
$date'
$update->
这里UPAATE就没有什么特殊的格式，基本上都是UPDATE数据库表SET字段名='
字段值'
判断条件（WHERE语句）。
这个加入了WHERE语句是为了更新某一条特定的记录。
七.如何使用phplib的Session功能
基本的Session使用方法
【ChinaByte教程】以下就是一个以用户登陆和注销为例子的Session使用例子，通过它你就会明白如何使用session以及Session是如何起作用的。
你也会体会到使用了Phplib/Zsulib的好处和带来的便利。
a.建立一个Session的类
classslashSessextendsSession
var$classname="
slashSess"
//和定义DB_Sql的道理一样
var$magic="
fkIsNotEqualToIK"
//随机化Session的字符串，建议用函数生成唯一串
var$mode="
cookie"
//在GET模式时使用cookie
var$lifetime=86400;
//sessioncookie的生存时间（单位：
秒）
var$that_class="
slash_sql"
//要使用的目标数据库名字（一般情况并没用上）
var$allowcache="
no"
//是否使用缓冲？
有3个选项:
no/public/private
}
其中slashSess这个名字可随便修改的，但是和定义DB_Sql的extends一样要保证和$classname名字一样就可以了。
其中这个定义了类slashSess的式子中，$magic的字串建议使用随机函数产生独立的字串以避免重复。
以下我给出一个小函数，以生成一个指定字长的独立随机串：
/*******************************************************************
function:
unimagic（）版本：
1.0日期：
2000/8/9编写地：
北京
parameter:
$length需要产生的随机串的长度，默认是8位，最长32位*******************************************************************/
functionunimagic（$length="
8"
）
{
srand（（double）microtime（）*1000000）;
$ran=rand（）;
$md5=md5（$ran）;
$magic=substr（$md5,0,$length）;
return$magic;
b.使用Session功能
本部分配合例子Login.php来说明如何运用Phplib/Zsulib中session.inc文件中相关函数/类，这里分几个部分：
利用page_open函数打开一个类对应方法的数组；
注册提交的一些参数；
利用page_close函数关闭页面同时保存注册的信息；
释放注册的参数。
结束一个Session会话。
这个小程序的流程（为了突出重点，这里尽量简化程序，多余的部分全部删除）初始化页面--->
page_open调用Session（开始）--->
$op=login，注册提交参数$op=logout，释放参数。
1.初始化页面
这里需要用到两个类slashDB和slashSess;
其中这两个类都在前面文档中提到。
这两个类假定存放在config.php文件里。
因此首先必须包含这个文件以便可以调用这两个类。
//////////////////////////////////
//范例页面ver0.12000/8/24//
//$ID:
Login.phpByhzqbbcinhp$//
require"
config.php"
//开始定义函数
functiondisplay_login（）{内容}
functionerror_msg（）{内容}
//结束定义函数
2.page_open调用Session开始
//调用page_open函数，其中slashSess是在config.php定义好的类
page_open（array（"
sess"
=>
））;
尽量不要在page_open前require一些会产生html代码或者进行输出html代码的操作。
否则会出现提示说已经发送了Header信息而不能再次发送的错误。
3.如果$op=login，进行登陆操作并注册信息：
if（$op=="
login"
{
if（isset（$passwd）&
&
isset（$username））//判断用户名和密码是否空？
否就继续
$sl_q=newslashDB;
//调用类
SELECTseclevFROMuserWHEREusername='
$passwd'
$sl_q->
//查询结果
//如果结果非空（意味着用户密码名字都正确）就继续
if（$sl_q->
next_record（））
$seclev=$sl_q->
seclev"
//给$seclev赋值
//调用register函数，将所有需要记录的变量全部注册
$sess->
register（"
username"
passwd"
}
4.如果$op=logout，进行注销信息操作
logout"
//调用delete函数删除注册的变量
delete（）;
//删除后，对变量进行重新赋值并初始化成原始状态
$seclev="
0"
$passwd="
$username="
exit;
echo"
你已经注销了!
5.结束本程序
在结束前必须调用page_close（）;
这样就完成了一个完整的Session会话。
如果已经执行了logout操作就不要执行了。
所以完整语句是：
if（$op!
="
）page_close（）;
结束：
一定要注意程序编写顺序，否则会产生逻辑错误。
本例子就是一个最简单的用户登陆的模型所有采用Phplib的用户管理模式都和这个差不多。
八.使用phplib编程具体例子
1.一些声明
关于本例子，本例子原来是为本协会（中山大学GNU/Linux协会）内部会员编写的，因此从比较长远的角度考虑来编写，考虑比较多的是代码编写规范和习惯与算法。
考虑到这些因素对编程也是很重要的，因此相关的章节与内容我并没有删除，如果读者觉得这部分没必要的话请email通知笔者，谢谢。
2.代码的编写风格
这里讲的不是如何写注释或者是如何写版权信息，而是提出若干比较有代表性和比较优美的编程习惯（这里称做风格）。
一般来说，php和perl等web脚本程序，都不可避免地和html等扯上关系。
而相当多的程序员并没有很好地注意自己的php/perl代码和html代码的关系，造成了程序行艰涩难懂，结构混乱最后连自己都懒得看的结局。
本人从开发ZSU-Slash-Pro的这一个月里发现，优秀的程序不仅仅有优秀的算法，还有优美而易懂的程序结构。
尤其对于大型程序来说，如果代码含糊，结构混乱的话，即使是程序开发者本人，看起代码也会觉得格外费力，其他人看起来就更加辛苦了。
因此很有必要摸索并制订出一套合适的编写代码的规范，用这套规范来约束和统一程序开发人员开发的代码风格。
使之易于阅读和修改，方便日后维护和进一步开发的人员，使调试程序简单化成为可能。
这里，我主要参考了PHPSlash和phplib和FreeTrade等几个中大型程序，结合自己的一点小经验，总结出了以下几点：
（1）.通用内容做成包含文件
这个方法是将每个生成的页面都会包含的通用内容做成包含文件，这样减少了程序的长度。
便于统一修改例如phpslash中它每个页面都要使用一个统一的Header/Footer，因此只需要创建两个包含文件slashhead.inc和slashfoot.inc文件，然后在每个php程序中使用require语句包含它们进入代码内部就可以了。
注意:
并不是只规定使用header和footer，如果你愿意，你可以添加任意多个require的部分。
（2）.公共函数库
对于那些经常使用的函数和变量，没必要在每个程序内都定义和声明，而只需要将
升级会员 