UniversalQuery 萬能查詢API插件

?? 簡介

UniversalQuery 是一個萬能查詢API插件，提供靈活強(qiáng)大的數(shù)據(jù)庫查詢接口，支持任意表查詢、連表查詢、條件篩選等功能，輸出JSON和XML格式數(shù)據(jù)。

? 特性

?? 萬能查詢 - 支持查詢?nèi)我鈹?shù)據(jù)表和字段
?? 連表查詢 - 支持多表JOIN（left join）查詢，自動識別關(guān)聯(lián)關(guān)系
?? 靈活條件 - 支持多種WHERE操作符（=、>、<、LIKE、IN等）
?? 聚合函數(shù) - 支持COUNT、SUM、AVG、MAX、MIN等統(tǒng)計(jì)查詢
?? 安全可靠 - 參數(shù)化查詢防SQL注入，基本安全檢查
?? 多格式輸出 - 支持JSON和XML格式
?? 完整文檔 - 內(nèi)置API文檔和使用示例

?? 快速開始

API接口

1. 萬能查詢接口

URL: /index.php?s=weapp/UniversalQuery/query

方法: GET/POST

參數(shù):

table (必需) - 表名，支持任意數(shù)據(jù)表
fields (可選) - 查詢字段，用逗號分隔，默認(rèn) *
join (可選) - 連表查詢（使用LEFT JOIN），格式：table1,table2
on (可選) - 自定義連表?xiàng)l件，格式：table1.field=table2.field
where (可選) - WHERE條件，格式：field:operator:value
limit (可選) - 限制條數(shù)，默認(rèn)10，最大50
page (可選) - 頁碼，默認(rèn)1，用于分頁查詢
offset (可選) - 偏移量，默認(rèn)0，直接指定起始位置
order (可選) - 排序字段，格式：field 或 field:desc
format (可選) - 返回格式：json/xml，默認(rèn)json

基本使用

1. 查詢文章列表

GET /index.php?s=weapp/UniversalQuery/query&table=archives&fields=aid,title,add_time&limit=5&order=aid:desc

2. 自定義連表?xiàng)l件帶on的

GET /index.php?s=weapp/UniversalQuery/query&table=archives&join=arctype&on=archives.typeid=arctype.id&fields=archives.title,arctype.typename&where=archives.status:=:1&limit=10

3. 多表連接（自定義ON條件）

GET /index.php?s=weapp/UniversalQuery/query&table=archives&join=product_content,arctype&on=product_content:archives.aid=product_content.aid,arctype:archives.typeid=arctype.id&fields=archives.title,product_content.seo_title,arctype.typename&where=archives.channel:=:2&limit=10

4. 統(tǒng)計(jì)文章數(shù)量

GET /index.php?s=weapp/UniversalQuery/query&table=archives&fields=count(*) as total&where=channel:=:1

5. 分頁查詢示例

# 頁碼分頁（第2頁，每頁10條）
GET /index.php?s=weapp/UniversalQuery/query&table=archives&limit=10&page=2

使用示例

JavaScript Ajax 調(diào)用

// 基礎(chǔ)查詢fetch('/index.php?s=weapp/UniversalQuery/query&table=archives&fields=aid,title&limit=5')
    .then(response => response.json())
    .then(data => {
        if (data.code === 1) {
            console.log('查詢成功:', data.data);
            console.log('記錄數(shù):', data.count);
        } else {
            console.error('查詢失敗:', data.msg);
        }
    });// 分頁查詢fetch('/index.php?s=weapp/UniversalQuery/query&table=archives&limit=10&page=2')
    .then(response => response.json())
    .then(data => {
        if (data.code === 1) {
            console.log('總記錄數(shù):', data.total);
            console.log('當(dāng)前頁:', data.pagination.current_page);
            console.log('總頁數(shù):', data.pagination.total_pages);
        }
    });

PHP 調(diào)用

// 基礎(chǔ)查詢$url = '/index.php?s=weapp/UniversalQuery/query&table=archives&where=channel:=:2&limit=10';$response = file_get_contents($url);$data = json_decode($response, true);if ($data['code'] === 1) {
    foreach ($data['data'] as $item) {
        echo $item['title'] . "\n";
    }}// POST請求查詢$postData = http_build_query([
    'table' => 'product_content',
    'fields' => 'aid,title,users_price',
    'where' => 'status:=:1,users_price:>:0',
    'limit' => 20,
    'order' => 'users_price:desc']);$context = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-type: application/x-www-form-urlencoded',
        'content' => $postData
    ]]);$response = file_get_contents('/index.php?s=weapp/UniversalQuery/query', false, $context);$data = json_decode($response, true);// 分頁查詢示例$url = '/index.php?s=weapp/UniversalQuery/query&table=archives&limit=10&page=2';$response = file_get_contents($url);$data = json_decode($response, true);if ($data['code'] === 1) {
    echo "總記錄數(shù): " . $data['total'] . "\n";
    echo "當(dāng)前頁: " . $data['pagination']['current_page'] . "\n";
    echo "總頁數(shù): " . $data['pagination']['total_pages'] . "\n";}

jQuery 示例

// 動態(tài)查詢表單$('#queryForm').on('submit', function(e) {
    e.preventDefault();
    
    const params = {
        table: $('#table').val(),
        fields: $('#fields').val() || '*',
        where: $('#where').val(),
        limit: $('#limit').val() || 10,
        order: $('#order').val()
    };
    
    $.get('/index.php?s=weapp/UniversalQuery/query', params)
        .done(function(data) {
            if (data.code === 1) {
                displayResults(data.data);
            } else {
                alert('查詢失敗: ' + data.msg);
            }
        });});