DSN连接方式
DB目前支持的连接方式如下
最完整的格式：
phptype(dbsyntax)://username:password@protocol+hostspec/database?option=value
别外还有一些缩写的格式：
phptype://username:password@protocol+hostspec:110//usr/db_file.db
phptype://username:password@hostspec/database
phptype://username:password@hostspec
phptype://username@hostspec
phptype://hostspec/database
phptype://hostspec
phptype:///database
phptype:///database?option=value&anotheroption=anothervalue
phptype(dbsyntax)
phptype
其中phptype表示数据库类型，可用的选项有：
dbase -> dBase
fbsql -> FrontBase
ibase -> InterBase
ifx -> Informix
msql -> Mini SQL
mssql -> Microsoft SQL Server
mysql -> MySQL (for MySQL <= 4.0)
mysqli -> MySQL (for MySQL >= 4.1) (since DB 1.6.3)
oci8 -> Oracle 7/8/9
odbc -> ODBC (Open Database Connectivity)
pgsql -> PostgreSQL
sqlite -> SQLite
sybase -> Sybase
以下是一些常用的连接例子：
l 连到一非标准端口的数据库
pgsql://user:pass@tcp(localhost:5555)/pear
l 通过SOCKET方式连到数据库
mysql://user@unix(/path/to/socket)/pear
l 在UNIX机上，连接SQLite数据库
sqlite:////full/unix/path/to/file.db?mode=0666
l 在Windows机上，连接SQLite数据库
sqlite:///c:/full/windows/path/to/file.db?mode=0666
l 使用SSL，连接到MySQLi
mysqli://user:pass@localhost/pear?key=client-key.pem&cert=client-cert.pem
l 通过ODBC连接到一个ACCESS数据库
odbc(access)://username:password@/datasourcename
DB连接实例
<?php
require_once 'DB.php';
$dsn = 'mysql://username:password@localhost/dbname';
/**
也可以用以下的方式
$dsn = array(
'phptype' => 'pgsql',
'username' => 'someuser',
'password' => 'apasswd',
'hostspec' => 'localhost',
'database' => 'thedb',
);
*/
//$options是可选的
$options = array(
'debug' => 2,
'portability' => DB_PORTABILITY_ALL,
);
$db =& DB::connect($dsn, $options);
if (DB::isError($db)) {
die($db->getMessage());
}
//设置数据库的默认查询方式
$db->setFetchMode(DB_FETCHMODE_ASSOC);
//执行一个普通的查询语句
$res =& $db->query('SELECT * FROM products');
//取得一个SQL查询的结果集行,列数
printf("共有%d行,%d列数据", $res->numRows(), $res->numCols());
//当前表的结构信息
echo ("<pre>");
print_r($db->tableInfo($res));
echo ("</pre>");
//执行一个带参数的查询
$sql = 'select * from products where products_id < ?';
$data = 50;
$res =& $db->query($sql, $data);
//执行含有多个参数的查询
$sql = 'select * from products where products_volt < ? and products_capacity > ?';
$data = array(10, 4000);
$res =& $db->query($sql, $data);
// 记得永远要检查执行的动作是否有错误
if (DB::isError($res)) {
die($res->getMessage());
}
//按默认方式DB_FETCHMODE_ORDERED，循环显示，输出结果,这种方式下，只能以序号的方式来访问数据字段
while ($row =& $res->fetchRow()) {
echo $row[0] . "<br />\n";
}
//按DB_FETCHMODE_ASSOC方式，循环显示，输出结果,这种方式下，以字段名称的方式来访问数据字段
while ($row =& $res->fetchRow(DB_FETCHMODE_ASSOC)) {
echo $row['id'] . "\n";
}
//获取指定范围的行数据
$from = 50;
$resPage = 10;
$to = $from + $resPage;
foreach (range($from, $to) as $rowNum) {
if (!$row =& $res->fetchRow($fetchmode, $rowNum)) {
break;
}
echo $row[0] . "\n";
}
//释放资源
$res->free();
//通过getAll()，可以获取整个查询的结果集
$result = $db->getAll("select * from tablename");
//得到UPDATE/INSERT/DELETE等语句,所影响的行数
$db->query('DELETE * FROM clients');
echo 'I have deleted ' . $db->affectedRows() . ' clients';
//close database connection
$db->disconnect();
?>
Prepare/Execute使用详解
当要多次执行一组查询,只是有些参数不同时
INSERT INTO tle_name(col1, col2) VALUES(‘val1’, val2);
INSERT INTO tle_name(col1, col2) VALUES(‘val3’, val4);
……
或者你的语句要符合多个不同语法的数据库时db1: INSERT INTO tbl_name (col1, col2) VALUES (expr1, expr2)
db2: INSERT INTO tbl_name SET col1=expr1, col2=expr2
可以使用prepare/execute语句,以提供更好的兼容性和可扩展性能
使用prepare/execute语句,要分2个步骤
1. 用prepare()来准备SQL语句:
假设你有一个类似于这样的SQL语句
SELECT surname, name, age
FROM person
WHERE name = 'name_to_find' AND age < age_limit
使用prepare()时,你可以这样来写:
SELECT surname, name, age
FROM person
WHERE name = ? AND age < ?
其中的?类似于JSP或其它语言中的参数变量,类似的还有:
?(推荐)
标准的用来代替数字(或字符)型变量的参数,它可以自动地eacape或根据当前的DBMS系统的需要,来quoted数据
!
stands for a scalar value and will inserted into the statement "as is"
&
请求一个已经存在的文件,这个文件的内容将用于替换&,常用于保存二进制文件或图象内容到数据库中
2.execute() 把变量传递给prepare的SQL语句,然后执行它,execute()需要2个参数,一个是prepare()调用时指定的变量,另一个就是要传递给?的变量(可以用数组)
一个简单的例子
<?php
// 假设你已经有一个有效的数据库连接变量$db …
$sth = $db->prepare('INSERT INTO numbers (number) VALUES (?)');
$db->execute($sth, 1);
$db->execute($sth, 8);
?>
一个保存图象到数据库的例子
假设数据库中有一个test表,它的结构如下:
CREATE TABLE `test` (
`id` int(11) NOT NULL auto_increment,
`name` varchar(100) default NULL,
`image` blob,
`description` text,
`note` text,
PRIMARY KEY (`id`)
) TYPE=MyISAM
insert.php
<?php
require_once 'DB.php';
$dsn = 'mysql://username:password@localhost/test';
$options = array(
'debug' => 2,
'portability' => DB_PORTABILITY_ALL,
);
$db =& DB::connect($dsn, $options);
if (DB::isError($db)) {
die($db->getMessage());
}
$db->setFetchMode(DB_FETCHMODE_ASSOC);
$sth = $db->prepare("INSERT test(name, image) VALUES(?, &)");
$db->execute($sth, array('jxyuhua', 'D://websamples//PEAR//Database//welcome.jpg'));
if (DB :: isError($db)) {
die($db->getMessage());
}
//$res->free();
$db->disconnect();
?>
存入数据库之后(注意内容大小的限制),你就可以再将内容取出来显示了
显示的例子
image.php
<?php
require_once 'DB.php';
$dsn = 'mysql://username:password@localhost/test';
$options = array(
'debug' => 2,
'portability' => DB_PORTABILITY_ALL,
);
$db =& DB::connect($dsn, $options);
if (DB::isError($db)) {
die($db->getMessage());
}
$db->setFetchMode(DB_FETCHMODE_ASSOC);
$res = $db->query("select image from test where name = ? order by name", $_REQUEST['name']);
if (DB :: isError($res)) {
die($res->getMessage());
}
while ($row = $res->fetchRow()) {
$data = $row['image'];
}
header("Content-type: image/jpeg"); //如果是其它的图象格式,如GIF,要做相应的更改image/gif
echo ($data);
$res->free();
$db->disconnect();
?>
DB允许你一次进行一组数据库操作,例如,你要一次性地插入/更新一批数据,
<?php
//假设数据库已经连接
$alldata = array(array(1, 'one', 'en'),
array(2, 'two', 'to'),
array(3, 'three', 'tre'),
array(4, 'four', 'fire'));
$sth = $db->prepare('INSERT INTO numbers VALUES (?, ?, ?)');
foreach ($alldata as $row) {
$db->execute($sth, $row);
}
?>
以上语句将执行等效于下面的SQL语句功能:
INSERT INTO numbers VALUES ('1', 'one', 'en')
INSERT INTO numbers VALUES ('2', 'two', 'to')
INSERT INTO numbers VALUES ('3', 'three', 'tre')
INSERT INTO numbers VALUES ('4', 'four', 'fire')
如果你想更省事一点,可以使用executeMultiple()
<?php
//假设数据库已经连接
$alldata = array(array(1, 'one', 'en'),
array(2, 'two', 'to'),
array(3, 'three', 'tre'),
array(4, 'four', 'fire'));
$sth = $db->prepare('INSERT INTO numbers VALUES (?, ?, ?)');
$db->executeMultiple($sth, $alldata);
?>
有没有这样的经历,当你在一个表中加了(或删除)一些字段之后,你原来的SQL语句就必须要重新写过,这样是不是很烦人?
例如,你有一个user表,它有3个字段(id, name, country),你以前的INSERT/UPDATE语句:
INSERT INTO user (id, name, country) VALUES (?, ?, ?)
UPDATE user SET id=?, name=?, country=? WHERE ...
当你增加了一个字段(假设是birthday)之后,你就必须重新你以前的INSERT/UPDATE语句,而这很有可能会导至BUG的出现(假设你漏改了某些地方).
现在让我们来看看怎样用autoPrepare()/autoExecute()来解决这个问题
1. autoPrepare()
用autoPrepare(),你不必列出INSERT/UPDATE的详细语句,而只要指定它的基本信息
resource autoPrepare (string $table, array $table_fields, integer $mode = DB_AUTOQUERY_INSERT [, string $where = FALSE])
$table 表名
$table_fields 要进行操作的字段名列表(数组类型)
$mode (DB_AUTOQUERY_INSERT || DB_AUTOQUERY_UPDATE)
$where WHERE语句,用于过滤数据
<?php
// 假设你已经有一个有效的数据库连接变量$db …
$table_name = 'user';
$table_fields = array('id', 'name', 'country');
$sth = $db->autoPrepare($table_name, $table_fields,
DB_AUTOQUERY_INSERT);
if (DB::isError($sth)) {
die($sth->getMessage());
}
$table_values = array(1, 'Fabien', 'France');
$res =& $db->execute($sth, $table_values);
if (DB::isError($res)) {
die($res->getMessage());
}
?>
在这个例子中,autoPrepare()会把它自动翻译成
INSERT INTO user (id, name, country) VALUES (?, ?, ?)
然后再自动调用prepare()
注意:如果你使用DB_AUTOQUERY_UPDATE, 记得指定$where条件,否则将更新所有的数据.
2.autoExecute()
autoExecute()是autoPrepare()和execute()的混合体,它可以方便地执行INSERT/UPDATE
DB_Result autoExecute (string $table, array $fields_values [, integer $mode = DB_AUTOQUERY_INSERT [, string $where = FALSE]])
$table 表名
$table_fields 要进行操作的字段名列表(数组类型)
$mode (DB_AUTOQUERY_INSERT || DB_AUTOQUERY_UPDATE)
$where WHERE语句,用于过滤数据
<?php
// 假设你已经有一个有效的数据库连接变量$db …
$table_name = 'user';
$fields_values = array(
'id' => 1,
'name' => 'Fabien',
'country' => 'France'
);
$res = $db->autoExecute($table_name, $fields_values,
DB_AUTOQUERY_INSERT);
if (DB::isError($res)) {
die($res->getMessage());
}
?>
它执行等效于下面的语句
INSERT INTO user (id, name, country) VALUES (1, 'Fabien', 'France')
是不是很方便?简直帅呆了!
注意:如果你使用DB_AUTOQUERY_UPDATE, 记得指定$where条件,否则将更新所有的数据.
