Destoon CMS 查询指南，如何高效利用标签调用功能？

Destoon 是一个基于 PHP+MySQL 的开源 B2B(电子商务)行业门户的首选解决方案，本文将详细介绍如何使用 Destoon 进行多表查询，并提供相应的 PHP 代码示例。

一、初始化系统

在开始使用 Destoon 进行查询之前，我们需要先初始化系统，这可以通过包含系统根目录下的common.inc.php 文件来实现，在站点根目录下创建一个hello.php 文件，代码如下：

<?php
require 'common.inc.php';
echo 'Hello World';
?>

二、多表查询示例

假设我们有两个表：一个是users 表，包含用户的基本信息；另一个是orders 表，包含用户的订单信息，这两个表通过 "用户ID" 字段进行关联。

建立数据库表

我们需要确保在 Destoon 中已经建立了相关的数据库表，并且这些表之间有适当的关联，以下是一个简单的 SQL 脚本，用于创建users 和orders 表：

CREATE TABLE users (
    user_id INT PRIMARY KEY,
    username VARCHAR(50),
    email VARCHAR(100)
);
CREATE TABLE orders (
    order_id INT PRIMARY KEY,
    user_id INT,
    product_name VARCHAR(100),
    quantity INT,
    FOREIGN KEY (user_id) REFERENCES users(user_id)
);

插入数据

我们可以向这两个表中插入一些数据：

INSERT INTO users (user_id, username, email) VALUES (1, '张三', 'zhangsan@example.com');
INSERT INTO users (user_id, username, email) VALUES (2, '李四', 'lisi@example.com');
INSERT INTO orders (order_id, user_id, product_name, quantity) VALUES (1, 1, '产品A', 2);
INSERT INTO orders (order_id, user_id, product_name, quantity) VALUES (2, 1, '产品B', 1);
INSERT INTO orders (order_id, user_id, product_name, quantity) VALUES (3, 2, '产品C', 3);

实现多表查询

我们可以使用 Destoon 提供的数据库操作类来执行多表查询，以下是一个示例代码，演示如何在 Destoon 中实现多表查询：

<?php
require 'common.inc.php';
$db = new DB(); // 实例化数据库操作类
// 定义查询条件
$condition = "u.user_id = o.user_id";
$fields = "u.username, u.email, o.product_name, o.quantity";
$table = "users u, orders o";
$order = "o.order_id DESC";
$pagesize = 10;
// 构建 SQL 查询语句
$sql = "SELECT $fields FROM $table WHERE $condition ORDER BY $order LIMIT $pagesize";
// 执行查询并获取结果
$result = $db>query($sql);
// 输出查询结果
while ($row = $db>fetch_array($result)) {
    echo "用户名: " . htmlspecialchars($row['username']) . "<br>";
    echo "邮箱: " . htmlspecialchars($row['email']) . "<br>";
    echo "产品名称: " . htmlspecialchars($row['product_name']) . "<br>";
    echo "数量: " . htmlspecialchars($row['quantity']) . "<br><hr>";
}
?>

在这个示例中，我们使用了 Destoon 的数据库操作类来执行一个多表查询，我们定义了查询的条件、字段、表名和排序方式，我们构建了一个 SQL 查询语句，并使用query 方法执行查询，我们使用fetch_array 方法遍历查询结果，并输出每一行的数据。

三、模糊查询与标签调用

模糊查询

在 Destoon 中，如果需要使用模糊查询（如 LIKE），可以使用% 通配符，要查找标题中包含某个品牌关键字的供应信息，可以使用以下标签调用：

<!{tag("moduleid=5&condition=title like '%".$title."%'&pagesize=10&order=hits desc&template=listsearch_rank")}>

注意：由于程序中可能会过滤掉%，可以规定一个特殊的字符串来绕过这个检查：

$parameter = str_replace(array('&', '%','$'), array('', '##','%'), $parameter);

标签调用详解

标签调用是根据调用条件从数据表读取指定数量的数据，并按排序方式排序，最终通过标签模板布局输出数据。

<!{tag("moduleid=5&condition=status=3&order=addtime desc&pagesize=10")}>

会被转换为如下的 SQL 语句：

SELECT * FROM destoon_sell WHERE status=3 ORDER BY addtime DESC LIMIT 0,10

读出的数据会保存在$tags 数组里，可以通过循环输出：

<!{php $tags=tag("moduleid=...&template=null");}>
{loop $tags $t}
...
{/loop}

或者直接在模板里循环数据：

<!{php $tags=tag("moduleid=...&template=null");}>
{foreach from=$tags item=t}
...
{/foreach}

四、相关参数说明

moduleid：模块 ID，可在后台模块管理里查询，对于直接调用模块的数据，设置正确的模块 ID 后，将不需要传递 table 参数，系统会自动获取。

table：表名，可在后台数据库维护里查询，对于 DESTOON 系统表，不需要加表的前缀；对于非 DESTOON 系统表，需要填写完整的表名，且传递 prefix 参数。

fields：查询的字段，默认为 *，可以传递例如 fields=title,addtime，但一般情况下无需传递，DESTOON 独有的标签缓存机制会自动缓存查询结果。

condition：查询的条件，如果不传递，则为 1，代表任意条件的数据（需了解 SQL 语法），status=3 表示正常通过的信息、status=3 and level=1 表示级别为 1 的信息等。

order：数据的排序方法（需了解 SQL 语法），order=addtime desc 表示按添加时间降序排列、order=itemid desc 表示按 itemid 降序排列等。

pagesize：调用数据的数量，如果不传递，默认为 10。

template：指定的标签模板，如果不传递，默认为 list，位于模板目录/tag/list.htm，如果传递为 null，表示不应用标签模板。

debug：调试参数，用于调试标签，系统将输出标签构造成的 SQL 语句，以便验证标签写法是否正确，不需要调试的标签不用加此参数。

sql：自 V9.0，支持直接传入 SQL 语句实现复杂的查询，例如sql=SELECT * FROM destoon_member m,destoon_company c WHERE c.userid=m.userid AND c.vip>0 LIMIT 10。