XIUNO数据库函数
- DB 配置
- db_insert()
- db_create()
- db_replace()
- db_update()
- db_delete()
- db_find_one()
- db_find()
- db_count()
- db_maxid()
- db_connect()
- db_truncate()
- db_sql_find()
- db_sql_find_one()
- db_exec()
- db_new()
- db_close()
DB 配置
在使用 DB 相关函数的时候，需要配置数据库相关信息。一般存放在文件中。
<?php
//新建配置文件 conf.php：
return array (
"db" => array (
"type" => "pdo_mysql",
"pdo_mysql" => array (
"master" => array (
"host" => "localhost",
"user" => "root",
"password" => "root",
"name" => "test",
"tablepre" => "bbs_",
"charset" => "utf8",
"engine" => "myisam",
),
"slaves" => array (),
),
),
);
?>db_insert()
db_insert($table, $arr, $d = NULL)#### 【功能】
插入一条记录，成功返回插入的 ID，失败返回 FALSE。
#### 【参数】
```
$table：表名
$arr：数组
$d：$db 实例，一般可以省略，使用配置文件指定的参数实例化的实例
```
【用例】
"Jack",
"email"=>"jack@email.com",
"gid"=>123,
);
$uid = db_insert("user", $arr);
if($uid === FALSE) {
echo $errstr;
} else {
echo "创建成功，uid : $uid";
}db_create()
db_create($table, $arr, $d = NULL)#### 【功能】
创建一条记录，成功返回插入的 ID，失败返回 FALSE。
功能与 db\_insert() 等价。
#### 【参数】
```
$table：表名
$arr：数组
$d：$db 实例
```
```
#### 【用例】
"Jack",
"email"=>"jack@email.com",
"gid"=>123,
);
$uid = db_create("user", $arr);
if($uid === FALSE) {
echo $errstr;
} else {
echo "创建成功，uid : $uid";
}db_replace()
db_replace($table, $arr, $d = NULL)#### 【功能】
替换的方式插入一条记录，成功返回插入的 ID，失败返回 FALSE。
#### 【参数】
```
$table：表名
$arr：数组
$d：$db 实例
```
#### 【用例】
"Jack",
"email"=>"jack@email.com",
"gid"=>123,
);
$uid = db_replace("user", $arr);
if($uid === FALSE) {
echo $errstr;
} else {
echo "替换创建成功，uid : $uid";
}db_update()
db_update($table, $cond, $update, $d = NULL)#### 【功能】
更新记录，成功返回受影响的行数，失败返回 FALSE。
#### 【参数】
```
$table：表名
$cond：条件
$update: 更新的数据
$d：$db 实例
```
#### 【$cond】
条件数组的格式：
// 单个条件：
array("gid"=>1)
// 多条：
array("gid"=>1, "uid"=>3)
// 大于
array("create_date"=>array(">"=>100))
// 小于
array("create_date"=>array("<"=>1000))
// LIKE
array("subject"=>array("LIKE"=>"关键字"))
// 组合：
array("gid"=>1, "create_date"=>array(">"=>100, "<"=>1000))#### 【用例】
``````
123),
array("username"=>"Mike"));
if($r === FALSE) {
echo $errstr;
} else {
echo "更新成功";
}db_delete()
db_delete($table, $cond, $d = NULL)#### 【功能】
删除记录，成功返回受影响的行数，失败返回 FALSE。
#### 【参数】
```
$table：表名
$cond：条件
$d：$db 实例
```
#### 【用例】
123));
if($r === FALSE) {
echo $errstr;
} else {
echo "删除成功";
}db_find_one()
【函数原型】
db_find_one($table, $cond = array(), $orderby = array(), $col = array(), $d = NULL)【功能】
查询数据库，成功返回一维数组（一条记录），失败返回 FALSE，并且自动记录到错误日志。
$table：表名
$cond：条件
$orderby: 排序方式
$col：查询哪些列
$d：$db 实例
【用例】
123));
print_r($arr);db_find()
【函数原型】
db_find($table, $cond = array(), $orderby = array(), $page = 1, $pagesize = 10, $key = "", $col = array(), $d = NULL)【功能】
查询数据库，成功返回二维数组（多条记录），失败返回 FALSE，并且自动记录到错误日志。
$table：表名
$cond：条件
$orderby：排序方式
$page： 页数
$pagesize：每页记录条数
$key：返回的数组用那一列的值作为 key
$col：查询哪些列
$d：$db 实例
#### 【$orderby】
条件数组的格式：
// 某个字段正序 - ORDER BY create_date ASC：
array("create_date"=>1)
// 某个字段倒序 - ORDER BY create_date DESC：
array("create_date"=>-1)
// 组合： ORDER BY gid ASC, create_date DESC：
array("gid"=>1, "create_date"=>-1)【用例】
1));
print_r($arrlist);
// 查找 g=1 && uid > 1 && uid < 100 的用户记录，返回所有符合的记录，并且按照 uid 正序排序（1: 正序； -1: 倒序）
$arrlist = db_find("user", array("gid"=>1, "uid"=>array(">"=>1, "<"=>100)), array("uid"=>1));
print_r($arrlist);db_count()
db_count($table, $cond = array(), $d = NULL)#### 【功能】
统计满足条件的行数，成功返回总行数，失败返回 FALSE。
#### 【参数】
$table：表名
$cond：条件
$d：$db 实例
db_maxid()
db_maxid($table, $field, $cond = array(), $d = NULL)#### 【功能】
查找表中某列最大值，成功返回最大值，失败返回 FALSE。
#### 【参数】
$table：表名
$field：列名
$cond：条件
$d：$db 实例
db_connect()
db_connect($d = NULL)#### 【功能】
测试数据库服务器能否联通，成功返回 TRUE，失败返回 FALSE。
#### 【参数】
$d：$db 实例
#### 【用例】
db_truncate()
db_truncate($table, $d = NULL)#### 【功能】
清空表数据，成功返回 TRUE，失败返回 FALSE。
#### 【参数】
$table：表名
$d：$db 实例
db_sql_find()
db_sql_find($sql, $key = NULL, $d = NULL)#### 【功能】
通过 SQL 的方式查询满足条件的记录，成功返回一个关联数组（包含多条记录），失败返回 FALSE。
#### 【参数】
$sql：SQL 语句，这个和 DB 驱动挂钩，目前仅支持 MYSQL
$key: 使用指定列的值作为返回数组的 key
$d：$db 实例
db_sql_find_one()
db_sql_find_one($sql, $d = NULL)#### 【功能】
通过 SQL 的方式查询一行记录，成功返回一个关联数组（包含一条记录），失败返回 FALSE。
#### 【参数】
$sql：SQL 语句，这个和 DB 驱动挂钩，目前仅支持 MYSQL
$d：$db 实例
db_exec()
db_exec($sql, $d = NULL)#### 【功能】
执行一条 SQL，成功返回受影响的行数，失败返回 FALSE。
#### 【参数】
$sql：SQL 语句，这个和 DB 驱动挂钩，目前仅支持 MYSQL
$d：$db 实例
db_new()
db_new($dbconf)#### 【功能】
查找表中某列最大值，成功返回最大值，失败返回 FALSE。
一般不需要调用此函数，除非需要多个 DB 连接。
#### 【参数】
$dbconf：DB 配置数据
#### 【用例】
"pdo_mysql",
"pdo_mysql" => array (
"master" => array (
"host" => "localhost",
"user" => "root",
"password" => "root",
"name" => "test",
"tablepre" => "bbs_",
"charset" => "utf8",
"engine" => "innodb",
),
"slaves" => array (),
),
);
include "./xiunophp/xiunophp.php";
$newdb = db_new($dbconf);
echo $newdb->version();db_close()
db_close($db = NULL)#### 【功能】
关闭 DB 连接。
#### 【参数】
$db：DB 实例
#### 【用例】
"pdo_mysql",
"pdo_mysql" => array (
"master" => array (
"host" => "localhost",
"user" => "root",
"password" => "root",
"name" => "test",
"tablepre" => "bbs_",
"charset" => "utf8",
"engine" => "innodb",
),
"slaves" => array (),
),
);
include "./xiunophp/xiunophp.php";
$newdb = db_new($dbconf);
db_close($newdb);
