Z-Blog Wiki

新版链式SQL操作组件

现在，用全新的链式SQL来查询数据库了！ 本页面的所有内容都是适合1.7及更高版本的！

注意：创建一个链式SQL实例，你可以用

$sql = $zbp->db->sql->get()
                    ->select('zbp_post')
                    ->where(array('=', 'log_ID', "1"))
                    ->sql;
 
#然后执行这行$sql再获取结果
$array = $zbp->db->Query($sql);

还有一种快捷方便去获取结果，例如我们获取评论的总数：

$array = $zbp->db->sql->get()
                      ->select('zbp_comment')
                      ->count(array('comm_ID'=>'num'))
                      ->query;
 
print_r($array);
 
#输出结果为 Array ( [0] => Array ( [num] => 25 ) )

另外，1.6.1及以后版本的$zbp→GetPostList函数(还有其它的GetXxxxList)的第一个参数$select均可以代入sql链式对象,GetListType函数和GetListOrigin也可以代入sql链式对象：

#先定义一个sql链对象，再获取结果
$posts = $zbp->GetPostList(
             $zbp->db->sql->get()->select('zbp_post')->where('=','log_CateID',1)
                          );

SQL SELECT

第1种写法 使用select指令

//取category表所有的数据
$sql = $zbp->db->sql->get()->select('zbp_category')->sql;
$array = $zbp->GetListType('Category', $sql);
//遍历数据输出等
foreach ($array as $a) {
    ...
}

$sql生成数据

SELECT * FROM zbp_category

第2种写法 使用selectany和from指令组合

//取category表的ID字段数组
$sql = $zbp->db->sql->get()->selectany('cate_ID')->from('zbp_category')->sql;
$array = $zbp->db->query($sql);

$sql生成数据

SELECT cate_ID FROM zbp_category

SQL WHERE 子句

取ID为1的文章

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(array('=', 'log_ID', "1"))
                           ->sql;
$articles = GetListType('Post', $sql);
$article = $articles[0];
 
// where(array('=', 'log_ID', "1"))  = 可以换成<>,LIKE,>=,<= 等等

#如果非要在where中拼接字符串请一定用addslashes转义单引号，比如where('log_Title LIKE \'%' . addslashes('字符串') . '%\'')

$sql生成数据

SELECT * FROM  zbp_post  WHERE  log_ID = '1'

AND 运算符

用AND选择2个条件，有更多的条件就继续增加where

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(array('=', 'log_Status', "1"))
                           ->where(array('=', 'log_Type', "0"))
                           ->sql;
$articles = GetListType('Post', $sql);

SELECT * FROM zbp_post WHERE log_Status = '1' AND log_Type = '0'

#where还可以先定义一个数组
$w = array();
$w[] = array('=', 'log_Type' ,'0');
$w[] = array('=', 'log_AuthorID' ,'1');
$w[] = array('=', 'log_CateID' ,'2');
#数组$w再代入
->where($w)

OR 运算符

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(
                               array('or',
                                   array(
                                       array('log_ID', '1'),
                                       array('log_Title', '2'),
                                   ),
                               )
                           )
                           ->sql;
#注意，此处的条件也可以写为->where('or',array('=', 'log_ID', '1'),array('=', 'log_Title', '2'))

SELECT * FROM zbp_post WHERE ((1 = 1) AND ( log_ID = '1' OR log_Title = '2' ) )

其它的几种OR类型

#自定义操作符的，like的，可以和写where条件一样
$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(
                               array('or',
                                   array(
                                       array('<>', 'log_ID', '1'),
                                       array('LIKE', 'log_Title', '2'),
                                   ),
                               )
                           )
                           ->sql;

SELECT * FROM zbp_post WHERE ((1 = 1) AND ( log_ID <> '1' OR log_Title LIKE '2' ) )

LIKE 操作符

一般用于搜索中，search和like的区别就是search会自动在字符两边加上%

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(array('search', 'log_Title', "Test"))
                           ->sql;

SELECT * FROM zbp_post WHERE ((1 = 1) AND ( (log_Title LIKE '%Test%') ) )

IN 操作符

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(array('IN', 'log_ID', array(1, 2, 3, 4)))
                           ->sql

SELECT * FROM  zbp_post  WHERE  ((1 = 1) AND (log_ID IN ( '1' ,  '2' ,  '3' ,  '4' ) ) )

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(array('NOT IN', 'log_ID', '(1, 2, 3)'))
                           ->sql

SELECT * FROM  zbp_post  WHERE  (log_ID NOT IN (1, 2, 3))

BETWEEN 操作符

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(array('between', 'log_ID', "1", "3"))
                           ->sql

SELECT * FROM  zbp_post  WHERE  (log_ID BETWEEN '1' AND '3')

EXISTS和NOT EXISTS 操作符

$sql = $zbp->db->sql->get()->select("zbp_post")
                ->where(array('exists', 'SELECT 1'))
                ->sql;

SELECT * FROM  zbp_post  WHERE  EXISTS ( SELECT 1 )

SQL 通配符

通配符有%和_还有[charlist],[^charlist]或[!charlist]

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where(array('like', 'log_Title', "_aidu"))
                           ->sql;

SELECT * FROM zbp_post WHERE ((1 = 1) AND ( (log_Title LIKE '_aidu') ) )

SELECT LIMIT

如果只给定一个参数，它表示返回最大的记录行数目，LIMIT n 等价于 LIMIT 0,n。

$sql = $zbp->db->sql->get()->select('zbp_post')
                           ->limit(5)
                           ->sql;

SELECT * FROM zbp_post LIMIT 5
//等于
SELECT * FROM zbp_post LIMIT 5 OFFSET 0

检索记录行从第6行开始，返回最多10行

$sql = $zbp->db->sql->get()->select('zbp_post')
                           ->limit(5,10)
                           ->sql;

SELECT * FROM zbp_post LIMIT 10 OFFSET 5

SELECT DISTINCT

关键词 DISTINCT 用于返回唯一不同的值。

$sql = $zbp->db->sql->get()->select('zbp_post')
                           ->distinct(array('log_Title'=>'t'), 'log_ID')
                           ->sql;

SELECT DISTINCT log_Title AS t,log_ID FROM zbp_post

SQL ORDER BY

ORDER BY 语句用于根据指定的列对结果集进行排序。ORDER BY 语句默认按照升序对记录进行排序。

$sql = $zbp->db->sql->get()->select('zbp_post')
                           ->orderBy(array('log_PostTime' => 'desc'), array('log_ID' => 'asc'))
                           ->sql;

SELECT * FROM zbp_post ORDER BY log_PostTime DESC, log_ID ASC

SQL GROUP BY 语句

我们取出每一个作者的所有文章的总评论数：

$sql = $zbp->db->sql->get()->select('zbp_post')
                           ->sum('log_CommNums')
                           ->groupBy('log_AuthorID')
                           ->sql;

SELECT SUM(log_CommNums) FROM zbp_post GROUP BY log_AuthorID

SQL HAVING 子句

在 SQL 中增加 HAVING 子句原因是，WHERE 关键字无法与合计函数一起使用。我们写一个例子，取出分类下文章评论总数大于100的所有的分类：

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->column('log_CateID')
                           ->column('SUM(log_CommNums)')
                           ->groupby('log_CateID')
                           ->having(array('>', 'SUM(log_CommNums)', '100'))
                           ->sql;

SELECT log_CateID,SUM(log_CommNums) FROM zbp_post GROUP BY log_CateID HAVING SUM(log_CommNums) > 100

SQL JOIN连接(LEFT JOIN RIGHT JOIN,FULL JOIN,INNER JOIN)

$sql = $zbp->db->sql->get()->selectany('log_ID')
                           ->from(array('zbp_post'=>'p'))
                           ->leftjoin(array('zbp_postrelation'=>'pr'))
                           ->on('p.log_ID = pr.pr_PostID')
                           ->where('1 = 1')
                           ->sql;
 
#这里只举例了LEFTJOIN联表查询，还分别给2个表分别设了别名

SELECT  log_ID  FROM zbp_post AS p LEFT JOIN zbp_postrelation AS pr ON p.log_ID = pr.pr_PostID WHERE 1 = 1

#如果要在Mysql下使用STRAIGHT_JOIN，请在链式sql加入option参数，
->option(array('straight_join' => true))

UNION, UNION ALL操作符

当使用 UNION 时，MySQL 会把结果集中重复的记录删掉，而使用 UNION ALL ，MySQL 会把所有的记录返回，且效率高于 UNION。

$sql = $zbp->db->sql->get()->union(
                              $zbp->db->sql->get()->select('zbp_table')->sql,
                              $zbp->db->sql->get()->select('zbp_table2')->sql
                           )
                           ->sql;

SELECT * FROM zbp_table UNION SELECT * FROM zbp_table2

SQL 别名

这是一个使用表别名和字段别名的例子：

$sql = $zbp->db->sql->get()->select(array('zbp_post'=>'p'))
                           ->column(array('log_ID'=>'id'))
                           ->column('log_Type AS type')
                           ->sql;

SELECT log_ID AS id,log_Type AS TYPE FROM zbp_post AS p

USEINDEX FORCEINDEX IGNOREINDEX

本指令是mysql专用的，分别是使用索引，强制使用索引，跳过索引

$sql = $zbp->db->sql->get()->select('zbp_post')
                           ->useindex('zbp_log_TPISC', 'zbp_log_VTSC')
                           ->sql;

SELECT * FROM zbp_post USE INDEX ( zbp_log_TPISC ,zbp_log_VTSC )

SQL INSERT INTO 语句

$sql = $zbp->db->sql->get()->insert('zbp_post')
                           ->data(array('log_Title' => 'test','log_Type' => '0'))
                           ->sql;

INSERT INTO zbp_post (log_Title,log_Type) VALUES ( 'test' , '0' )

SQL UPDATE 语句

$sql = $zbp->db->sql->get()->update('zbp_post')
                           ->where('=', 'log_ID', 1)
                           ->data(array('log_Title' => 'test','log_Type' => '1'))
                           ->sql;

UPDATE zbp_post SET log_Title = 'test', log_Type = '1' WHERE log_ID = '1'

SQL DELETE 语句

$sql = $zbp->db->sql->get()->delete('zbp_post')
                           ->where('=', 'log_ID', 1)
                           ->sql;

DELETE FROM zbp_post WHERE log_ID = '1'

CREATE 数据库，表，索引

CREATE DATABASE

可以在mysql和pgsql下创建数据库：

$sql = $zbp->db->sql->get()->create()->database('zbp')->ifnotexists()->sql;

CREATE DATABASE IF NOT EXISTS zbp

CREATE TABLE

这里的例子只是sql链用法的展示，实际上我们已经把sql链的方法包装好了，用$zbp→db→CreateTable方法会更便捷。创建一个表，先定义数据结构：

$tableData = array(
    'a' => array('a', 'integer', '', 0, '主ID'),
    'i' => array('i', 'boolean', '', false),
    'k' => array('k', 'string', 250, ''),
    'o' => array('o', 'string', 'longtext', '', '备注为某字段'),
    'r' => array('r', 'float', '', ''),
);
$sql = $zbp->db->sql->get()->create('zbp_table')
                            ->data($tableData)
                            ->option(array('engine' => 'InnoDB'))
                            ->option(array('charset' => 'utf8mb4'))
                            ->option(array('collate' => 'utf8mb4_general_ci'))
                            ->sql;
$zbp->db->query($sql);
 
echo $sql;

生成的$sql值为：

CREATE TABLE IF NOT EXISTS zbp_table ( a INT(11) NOT NULL AUTO_INCREMENT COMMENT '主ID', i tinyint(1) NOT NULL DEFAULT '0', k VARCHAR(250) NOT NULL DEFAULT '', o longtext NOT NULL COMMENT '备注为某字段', r FLOAT NOT NULL DEFAULT 0, PRIMARY KEY (a) ) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci AUTO_INCREMENT=1 ;

备注：可以指定表的引擎和字符集，如果不指定则从option文件读取系统的配置

CREATE INDEX

$sql = $zbp->db->sql->get()->create('zbp_post')
                           ->index(
                                     array('zbp_post_index_stt'=>array('log_Status','log_Type','log_Tag'))
                                  )
                           ->sql;

CREATE INDEX zbp_post_index_stt ON zbp_post ( log_Status , log_Type , log_Tag )

DROP 数据库，表，索引

DROP DATABASE

$sql = $zbp->db->sql->get()->drop()->database('zbp')->sql;

DROP DATABASE zbp

DROP TABLE

$sql = $zbp->db->sql->get()->drop()->table('zbp_table2')->ifexists()->sql;

DROP TABLE IF EXISTS zbp_table2

DROP INDEX

$sql = $zbp->db->sql->get()->drop('zbp_table')->index('zbp_table_id')->sql;

DROP INDEX zbp_table_id ON zbp_table

ALTER 修改添加字段

添加字段

$sql = $zbp->db->sql->get()->ALTER("zbp_post")
->ADDCOLUMN('log_IsHide integer NOT NULL DEFAULT \'0\'')
->ADDCOLUMN('log_CreateTime', 'integer NOT NULL DEFAULT \'0\'')
->ADDCOLUMN('log_Note', 'text', 'NOT NULL')
->sql;
#ADDCOLUMN内的参数可以写成一个，也可以写成多个

ALTER TABLE zbp_post ADD COLUMN log_IsHide INTEGER NOT NULL DEFAULT '0' ,ADD COLUMN log_CreateTime INTEGER NOT NULL DEFAULT '0' ,ADD COLUMN log_Note text NOT NULL

修改字段

只有mysql和pgsql支持，sqlite不能修改字段

$sql = $zbp->db->sql->get()->ALTER("zbp_post")
->ALTERCOLUMN('log_IsHide INTEGER NOT NULL DEFAULT \'0\'')
->sql;

#mysql生成
ALTER TABLE zbp_post MODIFY log_IsHide INTEGER NOT NULL DEFAULT '0'
#pgsql生成
ALTER TABLE zbp_post ALTER COLUMN log_IsHide INTEGER NOT NULL DEFAULT '0'

删除字段

$sql = $zbp->db->sql->get()->ALTER("zbp_post")
->DROPCOLUMN('log_IsHide')
->DROPCOLUMN('log_CreateTime')
->DROPCOLUMN('log_Note')
->sql;

ALTER TABLE zbp_post DROP COLUMN log_IsHide ,DROP COLUMN log_CreateTime ,DROP COLUMN log_Note

SQL 统计函数 AVG,COUNT,MIN,MAX,SUM

在这里我们仅以COUNT做为例子，取出每一个作者的文章总数并分组显示：

$sql = $zbp->db->sql->get()->select('zbp_post')
                           ->column('log_AuthorID')
                           ->count('log_ID')
                           ->where(array('=', 'log_Type' ,'0'))
                           ->groupBy('log_AuthorID')
                           ->sql;

SELECT log_AuthorID, COUNT(log_ID) FROM zbp_post WHERE log_Type = '0' GROUP BY log_AuthorID

SQL 随机取记录

1.7里新增了随机读取的功能，同时支持三种数据库

这里举例随机取5篇文章：

$sql = $zbp->db->sql->get()->select("zbp_post")
                           ->where('=','log_Type',0)
                           ->random(5)
                           ->sql;

--mysql生成的sql
SELECT * FROM zbp_post WHERE log_Type = '0' AND log_ID >= (SELECT FLOOR( RAND() * ((SELECT MAX(log_ID) FROM `zbp_post`)-(SELECT MIN(log_ID) FROM `zbp_post`)) + (SELECT MIN(log_ID) FROM `zbp_post`))) LIMIT 5
 
--pgsql和sqlite生成的sql
SELECT * FROM zbp_post WHERE log_Type = '0' ORDER BY Random() LIMIT 5

使用GetList函数随机获取文章的方法，在第7个参数中加上'random'⇒获取数量

GetList(null,null,null,null,null,null,array('random'=>5));
 
//1.7以更高版本的GetList加以改进了
GetList(array('random'=>4,'cate'=>1)); //获取分类1下的随机4篇文章

SQL 事务处理

BEGIN 开始一个事务
ROLLBACK 事务回滚
COMMIT 事务确认

#开始一个事务
$zbp->db->sql->get()->transaction('begin')->query;
#中间sql处理
#提交事务
$zbp->db->sql->get()->transaction('commit')->query;

BEGIN;
COMMIT;

Z-Blog Wiki

用户工具

站点工具

目录

新版链式SQL操作组件

SQL SELECT

SQL WHERE 子句

AND 运算符

OR 运算符

LIKE 操作符

IN 操作符

BETWEEN 操作符

EXISTS和NOT EXISTS 操作符

SQL 通配符

SELECT LIMIT

SELECT DISTINCT

SQL ORDER BY

SQL GROUP BY 语句

SQL HAVING 子句

SQL JOIN连接(LEFT JOIN RIGHT JOIN,FULL JOIN,INNER JOIN)

UNION, UNION ALL操作符

SQL 别名

USEINDEX FORCEINDEX IGNOREINDEX

SQL INSERT INTO 语句

SQL UPDATE 语句

SQL DELETE 语句

CREATE 数据库，表，索引

CREATE DATABASE

CREATE TABLE

CREATE INDEX

DROP 数据库，表，索引

DROP DATABASE

DROP TABLE

DROP INDEX

ALTER 修改 添加 字段

添加字段

修改字段

删除字段

SQL 统计函数 AVG,COUNT,MIN,MAX,SUM

SQL 随机取记录

SQL 事务处理

页面工具

ALTER 修改添加字段